Refactor createMarioDay function to enhance jump logic and coin spawning conditions [skip ci]

- Updated comments for clarity on enabling/disabling features across various seasonal scripts.
- Changed default value checks to ensure undefined values are handled consistently.
- Enhanced readability by providing descriptive comments for configuration variables.

[skip ci]

Jellyfin.Plugin.Seasonals/Configuration/PluginConfiguration.cs

@@ -18,40 +18,40 @@ public class PluginConfiguration : BasePluginConfiguration
         EnableClientSideToggle = true;
         
         Autumn = new AutumnOptions();
-        Snowflakes = new SnowflakesOptions();
-        Snowfall = new SnowfallOptions();
-        Snowstorm = new SnowstormOptions();
+        Birthday = new BirthdayOptions();
+        Carnival = new CarnivalOptions();
+        CherryBlossom = new CherryBlossomOptions();
+        Christmas = new ChristmasOptions();
+        EarthDay = new EarthDayOptions();
+        Easter = new EasterOptions();
+        Eid = new EidOptions();
+        Eurovision = new EurovisionOptions();
+        FilmNoir = new FilmNoirOptions();
         Fireworks = new FireworksOptions();
+        Friday13 = new Friday13Options();
+        Frost = new FrostOptions();
         Halloween = new HalloweenOptions();
         Hearts = new HeartsOptions();
-        Christmas = new ChristmasOptions();
-        Santa = new SantaOptions();
-        Easter = new EasterOptions();
-        Resurrection = new ResurrectionOptions();
-        Spring = new SpringOptions();
-        Summer = new SummerOptions();
-        CherryBlossom = new CherryBlossomOptions();
-        Carnival = new CarnivalOptions();
-        Matrix = new MatrixOptions();
-        Eurovision = new EurovisionOptions();
-        Storm = new StormOptions();
-        Pride = new PrideOptions();
-        EarthDay = new EarthDayOptions();
-        Rain = new RainOptions();
-        Frost = new FrostOptions();
-        FilmNoir = new FilmNoirOptions();
-        Oscar = new OscarOptions();
         MarioDay = new MarioDayOptions();
-        StarWars = new StarWarsOptions();
+        Matrix = new MatrixOptions();
         Oktoberfest = new OktoberfestOptions();
-        Friday13 = new Friday13Options();
-        Eid = new EidOptions();
+        Olympia = new OlympiaOptions();
+        Oscar = new OscarOptions();
+        Rain = new RainOptions();
+        Pride = new PrideOptions();
+        Resurrection = new ResurrectionOptions();
+        Santa = new SantaOptions();
+        Snowfall = new SnowfallOptions();
+        Snowflakes = new SnowflakesOptions();
+        Snowstorm = new SnowstormOptions();
+        Space = new SpaceOptions();
         Spooky = new SpookyOptions();
         Sports = new SportsOptions();
-        Olympia = new OlympiaOptions();
-        Space = new SpaceOptions();
+        Spring = new SpringOptions();
+        StarWars = new StarWarsOptions();
+        Storm = new StormOptions();
+        Summer = new SummerOptions();
         Underwater = new UnderwaterOptions();
-        Birthday = new BirthdayOptions();
     }
 
     /// <summary>
@@ -83,44 +83,43 @@ public class PluginConfiguration : BasePluginConfiguration
     /// Gets or sets the Seasonals options.
     /// </summary>
     public AutumnOptions Autumn { get; set; }
-    public SnowflakesOptions Snowflakes { get; set; }
-    public SnowfallOptions Snowfall { get; set; }
-    public SnowstormOptions Snowstorm { get; set; }
+    public BirthdayOptions Birthday { get; set; }
+    public CarnivalOptions Carnival { get; set; }
+    public CherryBlossomOptions CherryBlossom { get; set; }
+    public ChristmasOptions Christmas { get; set; }
+    public EarthDayOptions EarthDay { get; set; }
+    public EasterOptions Easter { get; set; }
+    public EidOptions Eid { get; set; }
+    public EurovisionOptions Eurovision { get; set; }
+    public FilmNoirOptions FilmNoir { get; set; }
     public FireworksOptions Fireworks { get; set; }
+    public Friday13Options Friday13 { get; set; }
+    public FrostOptions Frost { get; set; }
     public HalloweenOptions Halloween { get; set; }
     public HeartsOptions Hearts { get; set; }
-    public ChristmasOptions Christmas { get; set; }
-    public SantaOptions Santa { get; set; }
-    public EasterOptions Easter { get; set; }
-    public ResurrectionOptions Resurrection { get; set; }
-    public SpringOptions Spring { get; set; }
-    public SummerOptions Summer { get; set; }
-    public CherryBlossomOptions CherryBlossom { get; set; }
-    public CarnivalOptions Carnival { get; set; }
-    public MatrixOptions Matrix { get; set; }
-    public EurovisionOptions Eurovision { get; set; }
-    public StormOptions Storm { get; set; }
-    public PrideOptions Pride { get; set; }
-    public EarthDayOptions EarthDay { get; set; }
-    public RainOptions Rain { get; set; }
-    public FrostOptions Frost { get; set; }
-    public FilmNoirOptions FilmNoir { get; set; }
-    public OscarOptions Oscar { get; set; }
     public MarioDayOptions MarioDay { get; set; }
-    public StarWarsOptions StarWars { get; set; }
+    public MatrixOptions Matrix { get; set; }
     public OktoberfestOptions Oktoberfest { get; set; }
-    public Friday13Options Friday13 { get; set; }
-    public EidOptions Eid { get; set; }
+    public OlympiaOptions Olympia { get; set; }
+    public OscarOptions Oscar { get; set; }
+    public PrideOptions Pride { get; set; }
+    public RainOptions Rain { get; set; }
+    public ResurrectionOptions Resurrection { get; set; }
+    public SantaOptions Santa { get; set; }
+    public SnowfallOptions Snowfall { get; set; }
+    public SnowflakesOptions Snowflakes { get; set; }
+    public SnowstormOptions Snowstorm { get; set; }
+    public SpaceOptions Space { get; set; }
     public SpookyOptions Spooky { get; set; }
     public SportsOptions Sports { get; set; }
-    public OlympiaOptions Olympia { get; set; }
-    public SpaceOptions Space { get; set; }
+    public SpringOptions Spring { get; set; }
+    public StarWarsOptions StarWars { get; set; }
+    public StormOptions Storm { get; set; }
+    public SummerOptions Summer { get; set; }
     public UnderwaterOptions Underwater { get; set; }
-    public BirthdayOptions Birthday { get; set; }
 }
 
-public class AutumnOptions
-{
+public class AutumnOptions {
     public int LeafCount { get; set; } = 25;
     public bool EnableAutumn { get; set; } = true;
     public bool EnableRandomLeaves { get; set; } = true;
@@ -129,250 +128,206 @@ public class AutumnOptions
     public bool EnableRotation { get; set; } = false;
 }
 
-public class SnowflakesOptions
-{
-    public int SnowflakeCount { get; set; } = 25;
-    public bool EnableSnowflakes { get; set; } = true;
-    public bool EnableRandomSnowflakes { get; set; } = true;
-    public bool EnableRandomSnowflakesMobile { get; set; } = false;
-    public bool EnableColoredSnowflakes { get; set; } = true;
+public class BirthdayOptions {
+    public bool EnableBirthday { get; set; } = true;
+    public int SymbolCount { get; set; } = 12;
+    public int SymbolCountMobile { get; set; } = 5;
+    public bool EnableDifferentDuration { get; set; } = true;
+    public int ConfettiCount { get; set; } = 60;
+}
+
+public class CarnivalOptions {
+    public bool EnableCarnival { get; set; } = true;
+    public bool EnableDifferentDuration { get; set; } = true;
+    public bool EnableCarnivalSway { get; set; } = true;
+    public int ObjectCount { get; set; } = 120;
+    public int ObjectCountMobile { get; set; } = 60;
+}
+
+public class CherryBlossomOptions {
+    public bool EnableCherryBlossom { get; set; } = true;
+    public int PetalCount { get; set; } = 25;
+    public int PetalCountMobile { get; set; } = 15;
     public bool EnableDifferentDuration { get; set; } = true;
 }
 
-public class SnowfallOptions
-{
-    public int SnowflakesCount { get; set; } = 500;
-    public int SnowflakesCountMobile { get; set; } = 250;
-    public double Speed { get; set; } = 3;
-    public bool EnableSnowfall { get; set; } = true;
+public class ChristmasOptions {
+    public bool EnableChristmas { get; set; } = true;
+    public bool EnableRandomChristmas { get; set; } = true;
+    public bool EnableRandomChristmasMobile { get; set; } = false;
+    public bool EnableDifferentDuration { get; set; } = true;
+    public int SymbolCount { get; set; } = 25;
 }
 
-public class SnowstormOptions
-{
-    public int SnowflakesCount { get; set; } = 500;
-    public int SnowflakesCountMobile { get; set; } = 250;
-    public double Speed { get; set; } = 6;
-    public bool EnableSnowstorm { get; set; } = true;
-    public double HorizontalWind { get; set; } = 4;
-    public double VerticalVariation { get; set; } = 2;
+public class EarthDayOptions {
+    public bool EnableEarthDay { get; set; } = true;
+    public int VineCount { get; set; } = 4;
 }
 
-public class FireworksOptions
-{
-    public int ParticleCount { get; set; } = 50;
-    public int LaunchInterval { get; set; } = 3200;
+public class EasterOptions {
+    public bool EnableEaster { get; set; } = true;
+    public bool EnableBunny { get; set; } = true;
+    public int MinBunnyRestTime { get; set; } = 2000;
+    public int MaxBunnyRestTime { get; set; } = 5000;
+    public int EggCount { get; set; } = 15;
+}
+
+public class EidOptions {
+    public bool EnableEid { get; set; } = true;
+    public int LanternCount { get; set; } = 8;
+    public int LanternCountMobile { get; set; } = 3;
+}
+
+public class EurovisionOptions {
+    public bool EnableEurovision { get; set; } = true;
+    public int SymbolCount { get; set; } = 25;
+    public bool EnableDifferentDuration { get; set; } = true;
+    public bool EnableColorfulNotes { get; set; } = true;
+    public string EurovisionColors { get; set; } = "#ff0026ff,#17a6ffff,#32d432ff,#FFD700,#f0821bff,#f826f8ff";
+    public int EurovisionGlowSize { get; set; } = 2;
+}
+
+public class FilmNoirOptions {
+    public bool EnableFilmNoir { get; set; } = true;
+}
+
+public class FireworksOptions {
     public bool EnableFireworks { get; set; } = true;
     public bool ScrollFireworks { get; set; } = true;
+    public int ParticleCount { get; set; } = 50;
     public int MinFireworks { get; set; } = 3;
     public int MaxFireworks { get; set; } = 6;
+    public int LaunchInterval { get; set; } = 3200;
 }
 
-public class HalloweenOptions
-{
-    public int SymbolCount { get; set; } = 25;
+public class Friday13Options {
+    public bool EnableFriday13 { get; set; } = true;
+}
+
+public class FrostOptions {
+    public bool EnableFrost { get; set; } = true;
+}
+
+public class HalloweenOptions {
     public bool EnableHalloween { get; set; } = true;
     public bool EnableRandomSymbols { get; set; } = true;
     public bool EnableRandomSymbolsMobile { get; set; } = false;
     public bool EnableDifferentDuration { get; set; } = true;
     public bool EnableSpiders { get; set; } = true;
     public bool EnableMice { get; set; } = true;
+    public int SymbolCount { get; set; } = 25;
 }
 
-public class HeartsOptions
-{
-    public int SymbolCount { get; set; } = 25;
+public class HeartsOptions {
     public bool EnableHearts { get; set; } = true;
     public bool EnableRandomSymbols { get; set; } = true;
     public bool EnableRandomSymbolsMobile { get; set; } = false;
     public bool EnableDifferentDuration { get; set; } = true;
+    public int SymbolCount { get; set; } = 25;
 }
 
-public class ChristmasOptions
-{
+public class MarioDayOptions {
+    public bool EnableMarioDay { get; set; } = true;
+    public bool LetMarioJump { get; set; } = true;
+}
+
+public class MatrixOptions {
+    public bool EnableMatrix { get; set; } = true;
     public int SymbolCount { get; set; } = 25;
-    public bool EnableChristmas { get; set; } = true;
-    public bool EnableRandomChristmas { get; set; } = true;
-    public bool EnableRandomChristmasMobile { get; set; } = false;
+    public bool EnableMatrixBackground { get; set; } = false;
+    public string MatrixChars { get; set; } = "0123456789";
+}
+
+public class OktoberfestOptions {
+    public bool EnableOktoberfest { get; set; } = true;
+    public int SymbolCount { get; set; } = 25;
+    public int SymbolCountMobile { get; set; } = 10;
     public bool EnableDifferentDuration { get; set; } = true;
 }
 
-public class SantaOptions
-{
+public class OlympiaOptions {
+    public bool EnableOlympia { get; set; } = true;
+    public int SymbolCount { get; set; } = 25;
+    public int SymbolCountMobile { get; set; } = 10;
+    public bool EnableDifferentDuration { get; set; } = true;
+}
+
+public class OscarOptions {
+    public bool EnableOscar { get; set; } = true;
+}
+
+public class PrideOptions {
+    public bool EnablePride { get; set; } = true;
+    public int HeartCount { get; set; } = 20;
+    public int HeartSize { get; set; } = 1.5;
+    public bool ColorHeader { get; set; } = true;
+}
+
+public class RainOptions {
+    public bool EnableRain { get; set; } = true;
+    public int RaindropCount { get; set; } = 300;
+    public int RaindropCountMobile { get; set; } = 150;
+    public double RainSpeed { get; set; } = 1.0;
+}
+
+public class ResurrectionOptions {
+    public bool EnableResurrection { get; set; } = true;
+    public bool EnableRandomSymbols { get; set; } = true;
+    public bool EnableRandomSymbolsMobile { get; set; } = false;
+    public bool EnableDifferentDuration { get; set; } = true;
+    public int SymbolCount { get; set; } = 12;
+}
+
+public class SantaOptions {
+    public bool EnableSanta { get; set; } = true;
     public int SnowflakesCount { get; set; } = 500;
     public int SnowflakesCountMobile { get; set; } = 250;
+    public double SnowFallSpeed { get; set; } = 3;
     public double SantaSpeed { get; set; } = 10;
     public double SantaSpeedMobile { get; set; } = 8;
-    public bool EnableSanta { get; set; } = true;
-    public double SnowFallSpeed { get; set; } = 3;
     public double MaxSantaRestTime { get; set; } = 8;
     public double MinSantaRestTime { get; set; } = 3;
     public double MaxPresentFallSpeed { get; set; } = 5;
     public double MinPresentFallSpeed { get; set; } = 2;
 }
 
-public class EasterOptions
-{
-    public int EggCount { get; set; } = 20;
-    public bool EnableEaster { get; set; } = true;
-    public bool EnableRandomEaster { get; set; } = true;
-    public bool EnableRandomEasterMobile { get; set; } = false;
-    public bool EnableDifferentDuration { get; set; } = true;
-    public bool EnableBunny { get; set; } = true;
-    public int BunnyDuration { get; set; } = 12000;
-    public int HopHeight { get; set; } = 12;
-    public int MinBunnyRestTime { get; set; } = 2000;
-    public int MaxBunnyRestTime { get; set; } = 5000;
+public class SnowfallOptions {
+    public bool EnableSnowfall { get; set; } = true;
+    public int SnowflakesCount { get; set; } = 500;
+    public int SnowflakesCountMobile { get; set; } = 250;
+    public double Speed { get; set; } = 3;
 }
 
-public class ResurrectionOptions
-{
-    public int SymbolCount { get; set; } = 12;
-    public bool EnableResurrection { get; set; } = true;
-    public bool EnableRandomSymbols { get; set; } = true;
-    public bool EnableRandomSymbolsMobile { get; set; } = false;
+public class SnowflakesOptions {
+    public bool EnableSnowflakes { get; set; } = true;
+    public int SnowflakeCount { get; set; } = 25;
+    public bool EnableRandomSnowflakes { get; set; } = true;
+    public bool EnableRandomSnowflakesMobile { get; set; } = false;
+    public bool EnableColoredSnowflakes { get; set; } = true;
     public bool EnableDifferentDuration { get; set; } = true;
 }
 
-public class SpringOptions
-{
-    public int PollenCount { get; set; } = 30;
-    public int SunbeamCount { get; set; } = 5;
-    public int BirdCount { get; set; } = 4;
-    public int ButterflyCount { get; set; } = 4;
-    public int BeeCount { get; set; } = 2;
-    public int LadybugCount { get; set; } = 2;
-    public bool EnableSpring { get; set; } = true;
-    public bool EnableSpringSunbeams { get; set; } = true;
-    public bool EnableRandomSpring { get; set; } = true;
-    public bool EnableRandomSpringMobile { get; set; } = false;
+public class SnowstormOptions {
+    public bool EnableSnowstorm { get; set; } = true;
+    public int SnowflakesCount { get; set; } = 500;
+    public int SnowflakesCountMobile { get; set; } = 250;
+    public double Speed { get; set; } = 6;
+    public double HorizontalWind { get; set; } = 4;
+    public double VerticalVariation { get; set; } = 2;
+}
+
+public class SpaceOptions {
+    public bool EnableSpace { get; set; } = true;
+    public int PlanetCount { get; set; } = 6;
+    public int AstronautCount { get; set; } = 1;
+    public int SatelliteCount { get; set; } = 4;
+    public int IssCount { get; set; } = 1;
+    public int RocketCount { get; set; } = 1;
     public bool EnableDifferentDuration { get; set; } = true;
+    public int SymbolCountMobile { get; set; } = 2;
 }
 
-public class SummerOptions
-{
-    public int BubbleCount { get; set; } = 20;
-    public int DustCount { get; set; } = 50;
-    public bool EnableSummer { get; set; } = true;
-    public bool EnableRandomSummer { get; set; } = true;
-    public bool EnableRandomSummerMobile { get; set; } = false;
-    public bool EnableDifferentDuration { get; set; } = true;
-}
-
-public class CarnivalOptions
-{
-    public int ObjectCount { get; set; } = 25;
-    public bool EnableCarnival { get; set; } = true;
-    public bool EnableRandomCarnival { get; set; } = true;
-    public bool EnableRandomCarnivalMobile { get; set; } = false;
-    public bool EnableDifferentDuration { get; set; } = true;
-    public bool EnableCarnivalSway { get; set; } = true;
-}
-
-public class CherryBlossomOptions
-{
-    public int PetalCount { get; set; } = 25;
-    public bool EnableCherryBlossom { get; set; } = true;
-    public bool EnableRandomCherryBlossom { get; set; } = true;
-    public bool EnableRandomCherryBlossomMobile { get; set; } = false;
-    public bool EnableDifferentDuration { get; set; } = true;
-}
-
-public class MatrixOptions
-{
-    public int SymbolCount { get; set; } = 25;
-    public bool EnableMatrix { get; set; } = true;
-    public bool EnableRandomMatrix { get; set; } = true;
-    public bool EnableRandomMatrixMobile { get; set; } = false;
-    public bool EnableDifferentDuration { get; set; } = true;
-    public bool EnableMatrixBackground { get; set; } = false;
-    public string MatrixChars { get; set; } = "0123456789";
-}
-
-public class EurovisionOptions
-{
-    public int SymbolCount { get; set; } = 25;
-    public bool EnableEurovision { get; set; } = true;
-    public bool EnableRandomEurovision { get; set; } = true;
-    public bool EnableRandomEurovisionMobile { get; set; } = false;
-    public bool EnableDifferentDuration { get; set; } = true;
-    public bool EnableColorfulNotes { get; set; } = true;
-    public string EurovisionColors { get; set; } = "#ff0026ff,#17a6ffff,#32d432ff,#FFD700,#f0821bff,#f826f8ff";
-    public int EurovisionGlowSize { get; set; } = 8;
-}
-
-public class StormOptions
-{
-    public int RaindropCount { get; set; } = 300;
-    public int RaindropCountMobile { get; set; } = 150;
-    public bool EnableStorm { get; set; } = true;
-    public bool EnableLightning { get; set; } = true;
-    public double RainSpeed { get; set; } = 1;
-}
-
-public class PrideOptions
-{
-    public bool EnablePride { get; set; } = true;
-    public int HeartCount { get; set; } = 20;
-    public int HeartSize { get; set; } = 2;
-    public bool ColorHeader { get; set; } = true;
-}
-
-public class EarthDayOptions
-{
-    public bool EnableEarthDay { get; set; } = true;
-    public int VineCount { get; set; } = 4;
-}
-
-public class RainOptions
-{
-    public bool EnableRain { get; set; } = true;
-    public int RaindropCount { get; set; } = 300;
-    public int RaindropCountMobile { get; set; } = 150;
-    public double RainSpeed { get; set; } = 1;
-}
-
-public class FrostOptions
-{
-    public bool EnableFrost { get; set; } = true;
-}
-
-public class FilmNoirOptions
-{
-    public bool EnableFilmNoir { get; set; } = true;
-}
-
-public class OscarOptions
-{
-    public bool EnableOscar { get; set; } = true;
-}
-
-public class MarioDayOptions
-{
-    public bool EnableMarioDay { get; set; } = true;
-}
-
-public class StarWarsOptions
-{
-    public bool EnableStarWars { get; set; } = true;
-}
-
-public class OktoberfestOptions
-{
-    public bool EnableOktoberfest { get; set; } = true;
-}
-
-public class Friday13Options
-{
-    public bool EnableFriday13 { get; set; } = true;
-}
-
-public class EidOptions
-{
-    public bool EnableEid { get; set; } = true;
-}
-
-public class SpookyOptions
-{
+public class SpookyOptions {
     public bool EnableSpooky { get; set; } = true;
     public int SymbolCount { get; set; } = 25;
     public bool EnableDifferentDuration { get; set; } = true;
@@ -381,49 +336,54 @@ public class SpookyOptions
     public int SpookyGlowSize { get; set; } = 2;
 }
 
-public class SportsOptions
-{
-    public int SymbolCount { get; set; } = 5;
+public class SportsOptions {
     public bool EnableSports { get; set; } = true;
-    public bool EnableRandomSymbols { get; set; } = true;
-    public bool EnableRandomSymbolsMobile { get; set; } = false;
+    public int SymbolCount { get; set; } = 5;
     public bool EnableDifferentDuration { get; set; } = true;
     public string TurfColor { get; set; } = "#228b22";
     public string SportsBalls { get; set; } = "football,basketball,tennis,volleyball";
     public bool EnableTrophy { get; set; } = false;
+    public string ConfettiColors { get; set; } = "#000000,#FF0000,#FFCC00";
 }
 
-public class OlympiaOptions
-{
-    public int SymbolCount { get; set; } = 25;
-    public bool EnableOlympia { get; set; } = true;
-    public bool EnableRandomSymbols { get; set; } = true;
-    public bool EnableRandomSymbolsMobile { get; set; } = false;
+public class SpringOptions {
+    public bool EnableSpring { get; set; } = true;
+    public int PollenCount { get; set; } = 30;
+    public bool EnableSpringSunbeams { get; set; } = true;
+    public int SunbeamCount { get; set; } = 5;
+    public int BirdCount { get; set; } = 3;
+    public int ButterflyCount { get; set; } = 4;
+    public int BeeCount { get; set; } = 2;
+    public int LadybugCount { get; set; } = 2;
+    public int SymbolCountMobile { get; set; } = 2;
+}
+
+public class StarWarsOptions {
+    public bool EnableStarWars { get; set; } = true;
+}
+
+public class StormOptions {
+    public bool EnableStorm { get; set; } = true;
+    public int RaindropCount { get; set; } = 300;
+    public int RaindropCountMobile { get; set; } = 150;
+    public bool EnableLightning { get; set; } = true;
+    public double RainSpeed { get; set; } = 1.0;
+}
+
+public class SummerOptions {
+    public bool EnableSummer { get; set; } = true;
+    public int BubbleCount { get; set; } = 30;
+    public int DustCount { get; set; } = 50;
+    public int SymbolCountMobile { get; set; } = 2;
     public bool EnableDifferentDuration { get; set; } = true;
 }
 
-public class SpaceOptions
-{
-    public int PlanetCount { get; set; } = 12;
-    public int AstronautCount { get; set; } = 5;
-    public int SatelliteCount { get; set; } = 2;
-    public int IssCount { get; set; } = 1;
-    public int RocketCount { get; set; } = 1;
-    public bool EnableSpace { get; set; } = true;
-    public bool EnableRandomSymbols { get; set; } = true;
-    public bool EnableRandomSymbolsMobile { get; set; } = false;
-    public bool EnableDifferentDuration { get; set; } = true;
-}
-
-public class UnderwaterOptions
-{
-    public int SymbolCount { get; set; } = 15;
+public class UnderwaterOptions {
     public bool EnableUnderwater { get; set; } = true;
-    public bool EnableRandomSymbols { get; set; } = true;
-    public bool EnableRandomSymbolsMobile { get; set; } = false;
+    public int SymbolCountMobile { get; set; } = 2;
     public bool EnableDifferentDuration { get; set; } = true;
     public bool EnableLightRays { get; set; } = true;
-    public int SeaweedCount { get; set; } = 30;
+    public int SeaweedCount { get; set; } = 50;
     public int CrabCount { get; set; } = 2;
     public int StarfishCount { get; set; } = 2;
     public int ShellCount { get; set; } = 2;
@@ -431,15 +391,4 @@ public class UnderwaterOptions
     public int SeahorseCount { get; set; } = 3;
     public int JellyfishCount { get; set; } = 3;
     public int TurtleCount { get; set; } = 1;
-}
-
-public class BirthdayOptions
-{
-    public int SymbolCount { get; set; } = 5;
-    public int ConfettiCount { get; set; } = 60;
-    public bool EnableBirthday { get; set; } = true;
-    public bool EnableRandomSymbols { get; set; } = true;
-    public bool EnableRandomSymbolsMobile { get; set; } = false;
-    public bool EnableDifferentDuration { get; set; } = true;
-    public bool EnableGarland { get; set; } = true;
-}
+}

Jellyfin.Plugin.Seasonals/Web/autumn.js

@@ -1,11 +1,11 @@
 const config = window.SeasonalsPluginConfig?.Autumn || {};
 
-const leaves = config.EnableAutumn !== undefined ? config.EnableAutumn : true; // enable/disable leaves
+const leaves = config.EnableAutumn !== undefined ? config.EnableAutumn : true; // enable/disable autumn
 const randomLeaves = config.EnableRandomLeaves !== undefined ? config.EnableRandomLeaves : true; // enable random leaves
-const randomLeavesMobile = config.EnableRandomLeavesMobile !== undefined ? config.EnableRandomLeavesMobile : false; // enable random leaves on mobile devices (Warning: High values may affect performance)
-const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different duration for the random leaves
-const enableRotation = config.EnableRotation !== undefined ? config.EnableRotation : false; // enable/disable leaf rotation
-const leafCount = config.LeafCount || 25; // count of random extra leaves
+const randomLeavesMobile = config.EnableRandomLeavesMobile !== undefined ? config.EnableRandomLeavesMobile : false; // enable random leaves on mobile
+const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
+const enableRotation = config.EnableRotation !== undefined ? config.EnableRotation : false; // enable/disable rotation
+const leafCount = config.LeafCount !== undefined ? config.LeafCount : 25; // count of random extra leaves
 
 const images = [
   "../Seasonals/Resources/autumn_images/acorn1.png",

Jellyfin.Plugin.Seasonals/Web/birthday.js

@@ -1,11 +1,10 @@
 const config = window.SeasonalsPluginConfig?.Birthday || {};
 
-const birthday = config.EnableBirthday !== undefined ? config.EnableBirthday : true;
-const symbolCount = config.SymbolCount || 5;
-const useRandomSymbols = config.EnableRandomSymbols !== undefined ? config.EnableRandomSymbols : true;
-const enableRandomMobile = config.EnableRandomSymbolsMobile !== undefined ? config.EnableRandomSymbolsMobile : false;
-const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true;
-
+const birthday = config.EnableBirthday !== undefined ? config.EnableBirthday : true; // enable/disable birthday symbols
+const symbolCount = config.SymbolCount !== undefined ? config.SymbolCount : 15; // count of balloons
+const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different duration for the symbols
+const symbolCountMobile = config.SymbolCountMobile !== undefined ? config.SymbolCountMobile : 5; // count of mobile balloons
+const baseConfettiCount = config.ConfettiCount !== undefined ? config.ConfettiCount : 60; // count of confetti
 
 const birthdayImages = [
     '../Seasonals/Resources/birthday_assets/balloon_blue.gif',
@@ -142,15 +141,8 @@ function createBirthday() {
 
     // Cake and Garland have been removed
 
-    const standardCount = 15;
-    const totalSymbols = symbolCount + standardCount;
-    
     let isMobile = window.matchMedia("only screen and (max-width: 768px)").matches;
-    let finalCount = totalSymbols;
-
-    if (isMobile) {
-        finalCount = enableRandomMobile ? totalSymbols : standardCount;
-    }
+    let finalCount = isMobile ? symbolCountMobile : symbolCount;
 
     const useRandomDuration = enableDifferentDuration !== false;
 
@@ -254,8 +246,7 @@ function createBirthday() {
     }
 
     // Party Confetti
-    const baseConfettiCount = config.ConfettiCount !== undefined ? config.ConfettiCount : 60;
-    const confettiCount = isMobile ? Math.floor(baseConfettiCount / 2) : baseConfettiCount;
+    const confettiCount = baseConfettiCount;
     const allColors = ['#e6194b', '#3cb44b', '#ffe119', '#4363d8', '#f58231', '#911eb4', '#46f0f0', '#f032e6', '#bcf60c', '#fabebe', '#008080', '#e6beff', '#9a6324', '#fffac8', '#800000', '#aaffc3', '#808000', '#ffd8b1', '#000075', '#808080', '#ffffff', '#000000'];
     
     for (let i = 0; i < confettiCount; i++) {

Jellyfin.Plugin.Seasonals/Web/carnival.js

@@ -1,11 +1,10 @@
 const config = window.SeasonalsPluginConfig?.Carnival || {};
 
-const carnival = config.EnableCarnival !== undefined ? config.EnableCarnival : true; // Enable/disable carnival
-const randomCarnival = config.EnableRandomCarnival !== undefined ? config.EnableRandomCarnival : true; // Enable random carnival objects
-const randomCarnivalMobile = config.EnableRandomCarnivalMobile !== undefined ? config.EnableRandomCarnivalMobile : false; // Enable random carnival objects on mobile
-const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // Randomize falling and flutter speeds
-const enableSway = config.EnableCarnivalSway !== undefined ? config.EnableCarnivalSway : true; // Enable side-to-side sway animation
-const carnivalCount = config.ObjectCount || 120; // Number of confetti pieces to spawn
+const carnival = config.EnableCarnival !== undefined ? config.EnableCarnival : true; // enable/disable carnival
+const carnivalCount = config.ObjectCount !== undefined ? config.ObjectCount : 120; // Number of confetti pieces to spawn
+const carnivalCountMobile = config.ObjectCountMobile !== undefined ? config.ObjectCountMobile : 60; // Number of confetti pieces to spawn on mobile
+const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
+const enableSway = config.EnableCarnivalSway !== undefined ? config.EnableCarnivalSway : true; // enable/disable carnivalsway
 
 const confettiColors = [
     '#fce18a', '#ff726d', '#b48def', '#f4306d', 
@@ -41,7 +40,6 @@ function toggleCarnival() {
   }
 }
 
-// observe changes in the DOM
 const observer = new MutationObserver(toggleCarnival);
 observer.observe(document.body, {
   childList: true,
@@ -149,19 +147,8 @@ function createConfettiPiece(container, isInitial = false) {
     container.appendChild(wrapper);
 }
 
-function addRandomCarnivalObjects(count) {
-  const carnivalContainer = document.querySelector('.carnival-container');
-  if (!carnivalContainer) return;
-
-  console.log('Adding random carnival confetti');
-
-    for (let i = 0; i < count; i++) {
-        createConfettiPiece(carnivalContainer, true);
-    }
-}
-
 // initialize standard carnival objects
-function initCarnivalObjects() {
+function initCarnivalObjects(count) {
     let container = document.querySelector('.carnival-container');
     if (!container) {
         container = document.createElement("div");
@@ -171,7 +158,7 @@ function initCarnivalObjects() {
     }
 
     // Initial confetti
-    for (let i = 0; i < 60; i++) {
+    for (let i = 0; i < count; i++) {
         createConfettiPiece(container, true);
     }
 }
@@ -179,13 +166,12 @@ function initCarnivalObjects() {
 // initialize carnival
 function initializeCarnival() {
   if (!carnival) return;
-    initCarnivalObjects();
-    toggleCarnival();
 
     const screenWidth = window.innerWidth;
-    if (randomCarnival && (screenWidth > 768 || randomCarnivalMobile)) {
-        addRandomCarnivalObjects(carnivalCount);
-    }
+    const count = screenWidth > 768 ? carnivalCount : carnivalCountMobile;
+
+    initCarnivalObjects(count);
+    toggleCarnival();
 }
 
 initializeCarnival();

Jellyfin.Plugin.Seasonals/Web/cherryblossom.js

@@ -1,10 +1,9 @@
 const config = window.SeasonalsPluginConfig?.CherryBlossom || {};
 
-const cherryBlossom = config.EnableCherryBlossom !== undefined ? config.EnableCherryBlossom : true;
-const petalCount = config.PetalCount || 25;
-const randomCherryBlossom = config.EnableRandomCherryBlossom !== undefined ? config.EnableRandomCherryBlossom : true;
-const randomCherryBlossomMobile = config.EnableRandomCherryBlossomMobile !== undefined ? config.EnableRandomCherryBlossomMobile : false;
-const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true;
+const cherryBlossom = config.EnableCherryBlossom !== undefined ? config.EnableCherryBlossom : true; // enable/disable cherryblossom
+const petalCount = config.PetalCount !== undefined ? config.PetalCount : 25; // count of petal
+const petalCountMobile = config.PetalCountMobile !== undefined ? config.PetalCountMobile : 10; // count of petal on mobile
+const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
 
 let msgPrinted = false;
 
@@ -67,16 +66,7 @@ function createPetal(container) {
     container.appendChild(petal);
 }
 
-function addRandomObjects() {
-    const container = document.querySelector('.cherryblossom-container');
-    if (!container) return;
-
-    for (let i = 0; i < petalCount; i++) {
-        createPetal(container);
-    }
-}
-
-function initObjects() {
+function initObjects(count) {
     let container = document.querySelector('.cherryblossom-container');
     if (!container) {
         container = document.createElement("div");
@@ -86,20 +76,19 @@ function initObjects() {
     }
     
     // Initial batch
-    for (let i = 0; i < 15; i++) {
+    for (let i = 0; i < count; i++) {
         createPetal(container);
     }
 }
 
 function initializeCherryBlossom() {
     if (!cherryBlossom) return;
-    initObjects();
-    toggleCherryBlossom();
 
     const screenWidth = window.innerWidth;
-    if (randomCherryBlossom && (screenWidth > 768 || randomCherryBlossomMobile)) {
-        addRandomObjects();
-    }
+    const count = screenWidth > 768 ? petalCount : petalCountMobile;
+
+    initObjects(count);
+    toggleCherryBlossom();
 }
 
 initializeCherryBlossom();

Jellyfin.Plugin.Seasonals/Web/christmas.js

@@ -1,10 +1,10 @@
 const config = window.SeasonalsPluginConfig?.Christmas || {};
 
 const christmas = config.EnableChristmas !== undefined ? config.EnableChristmas : true; // enable/disable christmas
-const randomChristmas = config.EnableRandomChristmas !== undefined ? config.EnableRandomChristmas : true; // enable random Christmas
-const randomChristmasMobile = config.EnableRandomChristmasMobile !== undefined ? config.EnableRandomChristmasMobile : false; // enable random Christmas on mobile devices (Warning: High values may affect performance)
-const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different duration for the random Christmas symbols
-const christmasCount = config.SymbolCount || 25; // count of random extra christmas
+const randomChristmas = config.EnableRandomChristmas !== undefined ? config.EnableRandomChristmas : true; // enable random christmas
+const randomChristmasMobile = config.EnableRandomChristmasMobile !== undefined ? config.EnableRandomChristmasMobile : false; // enable random christmas on mobile
+const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
+const christmasCount = config.SymbolCount !== undefined ? config.SymbolCount : 25; // count of symbol
 
 // Array of christmas characters
 const christmasSymbols = ['❆', '🎁', '❄️', '🎁', '🎅', '🎊', '🎁', '🎉'];

Jellyfin.Plugin.Seasonals/Web/earthday.js

@@ -1,7 +1,7 @@
 const config = window.SeasonalsPluginConfig?.EarthDay || {};
 
-const enabled = config.EnableEarthDay !== undefined ? config.EnableEarthDay : true;
-const vineCount = config.VineCount || 4;
+const enabled = config.EnableEarthDay !== undefined ? config.EnableEarthDay : true; // enable/disable earthday
+const vineCount = config.VineCount !== undefined ? config.VineCount : 4; // count of vine
 
 const flowerColors = ['#FF69B4', '#FFD700', '#87CEFA', '#FF4500', '#BA55D3', '#FFA500', '#FF1493'];
 

Jellyfin.Plugin.Seasonals/Web/easter.js

@@ -1,18 +1,19 @@
 const config = window.SeasonalsPluginConfig?.Easter || {};
 
-const easter = config.EnableEaster !== undefined ? config.EnableEaster : true;
-const enableBunny = config.EnableBunny !== undefined ? config.EnableBunny : true;
+const easter = config.EnableEaster !== undefined ? config.EnableEaster : true; // enable/disable easter
+const enableBunny = config.EnableBunny !== undefined ? config.EnableBunny : true; // enable/disable bunny
+const minBunnyRestTime = config.MinBunnyRestTime !== undefined ? config.MinBunnyRestTime : 2000; // timing parameter
+const maxBunnyRestTime = config.MaxBunnyRestTime !== undefined ? config.MaxBunnyRestTime : 5000; // timing parameter
+const eggCount = config.EggCount !== undefined ? config.EggCount : 15; // count of egg
+
 /* MARK: Bunny movement config */
 const jumpDistanceVw = 5; // Distance in vw the bunny covers per jump
 const jumpDurationMs = 770; // Time in ms the bunny spends moving during a jump
 const pauseDurationMs = 116.6666; // Time in ms the bunny pauses between jumps
 
-const minBunnyRestTime = config.MinBunnyRestTime || 2000;
-const maxBunnyRestTime = config.MaxBunnyRestTime || 5000;
-const eggCount = config.EggCount || 15;
-
 const rabbit = "../Seasonals/Resources/easter_images/Osterhase.gif";
 
+// Credit: https://flaticon.com
 const easterEggImages = [
     "../Seasonals/Resources/easter_images/egg_1.png",
     "../Seasonals/Resources/easter_images/egg_2.png",
@@ -197,7 +198,7 @@ function animateRabbit(rabbit) {
 
     rabbit.style.transition = 'none';
     const transformScale = startFromLeft ? 'scaleX(-1)' : '';
-    // Fix bounding box center-of-gravity shift when graphic is flipped
+    // Set bounding box center-of-gravity shift when graphic is flipped
     rabbit.style.transformOrigin = startFromLeft ? '59% 50%' : '50% 50%';
     rabbit.style.transform = `translateX(${currentX}vw) ${transformScale}`;
 
@@ -213,8 +214,6 @@ function animateRabbit(rabbit) {
 
         if (!startTime) {
             startTime = timestamp;
-            // resetting gif, appending a timestamp cache-buster forces the browser 
-            // to reload and start the GIF strictly from the first frame.
             const currSrc = rabbit.src.split('?')[0];
             rabbit.src = currSrc + '?t=' + Date.now();
         }
@@ -236,7 +235,6 @@ function animateRabbit(rabbit) {
 
         currentX = startX + (completedLoops * jumpDistanceVw + currentLoopDistance) * direction;
         
-        // Update DOM without CSS transitions
         rabbit.style.transform = `translateX(${currentX}vw) ${transformScale}`;
 
         // Check if finished crossing

Jellyfin.Plugin.Seasonals/Web/eid.js

@@ -1,5 +1,7 @@
 const config = window.SeasonalsPluginConfig?.Eid || {};
-const eid = config.EnableEid !== undefined ? config.EnableEid : true;
+const eid = config.EnableEid !== undefined ? config.EnableEid : true; // enable/disable eid
+const lanternCount = config.LanternCount !== undefined ? config.LanternCount : 8; // count of lantern
+const lanternCountMobile = config.LanternCountMobile !== undefined ? config.LanternCountMobile : 3; // count of lantern on mobile
 
 const eidSymbols = ['🌙', '⭐', '✨'];
 
@@ -39,11 +41,13 @@ observer.observe(document.body, {
 
 function createEid(container) {
     const starCount = 20;
-    const lanternCount = Math.floor(Math.random() * 3) + 4; // 4 to 6 lanterns
+    
+    let isMobile = window.matchMedia("only screen and (max-width: 768px)").matches;
+    let activeLanternCount = isMobile ? lanternCountMobile : lanternCount;
 
     // Create evenly spaced lanterns
-    const segmentWidth = 100 / lanternCount;
-    for (let i = 0; i < lanternCount; i++) {
+    const segmentWidth = 100 / activeLanternCount;
+    for (let i = 0; i < activeLanternCount; i++) {
         const symbol = document.createElement('div');
         symbol.className = 'eid-symbol lantern-rope';
         

Jellyfin.Plugin.Seasonals/Web/eurovision.js

@@ -1,15 +1,14 @@
 const config = window.SeasonalsPluginConfig?.Eurovision || {};
 
-const enabled = config.EnableEurovision !== undefined ? config.EnableEurovision : true;
-const elementCount = config.SymbolCount || 25;
-const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true;
-const enableColorfulNotes = config.EnableColorfulNotes !== undefined ? config.EnableColorfulNotes : true;
-const eurovisionColorsStr = config.EurovisionColors || '#ff0026ff, #17a6ffff, #32d432ff, #FFD700, #f0821bff, #f826f8ff';
-const glowSize = config.EurovisionGlowSize !== undefined ? config.EurovisionGlowSize : 2;
+const enabled = config.EnableEurovision !== undefined ? config.EnableEurovision : true; // enable/disable eurovision
+const elementCount = config.SymbolCount !== undefined ? config.SymbolCount : 25; // count of notes
+const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
+const enableColorfulNotes = config.EnableColorfulNotes !== undefined ? config.EnableColorfulNotes : true; // enable/disable colorful notes
+const eurovisionColorsStr = config.EurovisionColors !== undefined ? config.EurovisionColors : '#ff0026ff, #17a6ffff, #32d432ff, #FFD700, #f0821bff, #f826f8ff'; // colors to use
+const glowSize = config.EurovisionGlowSize !== undefined ? config.EurovisionGlowSize : 2; // size of eurovision glow
 
 let msgPrinted = false;
 
-// Toggle Function
 function toggleEurovision() {
   const container = document.querySelector('.eurovision-container');
   if (!container) return;

Jellyfin.Plugin.Seasonals/Web/filmnoir.js

@@ -1,5 +1,5 @@
 const config = window.SeasonalsPluginConfig?.FilmNoir || {};
-const filmnoir = config.EnableFilmNoir !== undefined ? config.EnableFilmNoir : true;
+const filmnoir = config.EnableFilmNoir !== undefined ? config.EnableFilmNoir : true; // enable/disable filmnoir
 
 let msgPrinted = false;
 

Jellyfin.Plugin.Seasonals/Web/fireworks.js

@@ -2,10 +2,10 @@ const config = window.SeasonalsPluginConfig?.Fireworks || {};
 
 const fireworks = config.EnableFireworks !== undefined ? config.EnableFireworks : true; // enable/disable fireworks
 const scrollFireworks = config.ScrollFireworks !== undefined ? config.ScrollFireworks : true; // enable fireworks to scroll with page content
-const particlesPerFirework = config.ParticleCount || 50; // count of particles per firework (Warning: High values may affect performance)
-const minFireworks = config.MinFireworks || 3; // minimum number of simultaneous fireworks
-const maxFireworks = config.MaxFireworks || 6; // maximum number of simultaneous fireworks
-const intervalOfFireworks = config.LaunchInterval || 3200; // interval for the fireworks in milliseconds
+const particlesPerFirework = config.ParticleCount !== undefined ? config.ParticleCount : 50; // count of particles per firework
+const minFireworks = config.MinFireworks !== undefined ? config.MinFireworks : 3; // minimum number of simultaneous fireworks
+const maxFireworks = config.MaxFireworks !== undefined ? config.MaxFireworks : 6; // maximum number of simultaneous fireworks
+const intervalOfFireworks = config.LaunchInterval !== undefined ? config.LaunchInterval : 3200; // interval for the fireworks in milliseconds
 
 // array of color palettes for the fireworks
 const colorPalettes = [

Jellyfin.Plugin.Seasonals/Web/friday13.js

@@ -1,5 +1,5 @@
 const config = window.SeasonalsPluginConfig?.Friday13 || {};
-const friday13 = config.EnableFriday13 !== undefined ? config.EnableFriday13 : true;
+const friday13 = config.EnableFriday13 !== undefined ? config.EnableFriday13 : true; // enable/disable friday13
 
 let msgPrinted = false;
 

Jellyfin.Plugin.Seasonals/Web/frost.js

@@ -1,6 +1,6 @@
 const config = window.SeasonalsPluginConfig?.Frost || {};
 
-const frost = config.EnableFrost !== undefined ? config.EnableFrost : true;
+const frost = config.EnableFrost !== undefined ? config.EnableFrost : true; // enable/disable frost
 
 let msgPrinted = false;
 

Jellyfin.Plugin.Seasonals/Web/halloween.js

@@ -1,12 +1,12 @@
 const config = window.SeasonalsPluginConfig?.Halloween || {};
 
 const halloween = config.EnableHalloween !== undefined ? config.EnableHalloween : true; // enable/disable halloween
-const randomSymbols = config.EnableRandomSymbols !== undefined ? config.EnableRandomSymbols : true; // enable more random symbols
-const randomSymbolsMobile = config.EnableRandomSymbolsMobile !== undefined ? config.EnableRandomSymbolsMobile : false; // enable random symbols on mobile devices (Warning: High values may affect performance)
-const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different duration for the random halloween symbols
-const enableSpiders = config.EnableSpiders !== undefined ? config.EnableSpiders : true;
-const enableMice = config.EnableMice !== undefined ? config.EnableMice : true;
-const halloweenCount = config.SymbolCount || 25; // count of random extra symbols
+const randomSymbols = config.EnableRandomSymbols !== undefined ? config.EnableRandomSymbols : true; // enable random symbols
+const randomSymbolsMobile = config.EnableRandomSymbolsMobile !== undefined ? config.EnableRandomSymbolsMobile : false; // enable random symbols on mobile
+const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
+const enableSpiders = config.EnableSpiders !== undefined ? config.EnableSpiders : true; // enable/disable spiders
+const enableMice = config.EnableMice !== undefined ? config.EnableMice : true; // enable/disable mice
+const halloweenCount = config.SymbolCount !== undefined ? config.SymbolCount : 25; // count of symbols
 
 const images = [
   "../Seasonals/Resources/halloween_images/ghost_20x20.png",
@@ -14,7 +14,7 @@ const images = [
   "../Seasonals/Resources/halloween_images/pumpkin_20x20.png",
 ];
 
-let msgPrinted = false; // flag to prevent multiple console messages
+let msgPrinted = false;
 
 // function to check and control the halloween
 function toggleHalloween() {
@@ -42,7 +42,6 @@ function toggleHalloween() {
   }
 }
 
-// observe changes in the DOM
 const observer = new MutationObserver(toggleHalloween);
 observer.observe(document.body, {
   childList: true,
@@ -52,26 +51,22 @@ observer.observe(document.body, {
 
 
 function addRandomSymbols(count) {
-  const halloweenContainer = document.querySelector('.halloween-container'); // get the halloween container
-  if (!halloweenContainer) return; // exit if halloween container is not found
+  const halloweenContainer = document.querySelector('.halloween-container');
+  if (!halloweenContainer) return;
 
   console.log('Adding random halloween symbols');
 
 
   for (let i = 0; i < count; i++) {
-    // create a new halloween elements
     const halloweenDiv = document.createElement("div");
     halloweenDiv.className = "halloween";
 
-    // pick a random halloween symbol
     const imageSrc = images[Math.floor(Math.random() * images.length)];
     const img = document.createElement("img");
     img.src = imageSrc;
 
     halloweenDiv.appendChild(img);
 
-
-    // set random horizontal position, animation delay and size(uncomment lines to enable) 
     const randomLeft = Math.random() * 100; // position (0% to 100%)
     const randomAnimationDelay = Math.random() * 10; // delay (0s to 10s)
     const randomAnimationDelay2 = -(Math.random() * 3); // delay (-3s to 0s)
@@ -87,13 +82,11 @@ function addRandomSymbols(count) {
       halloweenDiv.style.animationDuration = `${randomAnimationDuration}s, ${randomAnimationDuration2}s`;
     }
 
-    // add the halloween to the container
     halloweenContainer.appendChild(halloweenDiv);
   }
   console.log('Random halloween symbols added');
 }
 
-// create halloween objects
 function createHalloween() {
   const container = document.querySelector('.halloween-container') || document.createElement("div");
 
@@ -235,9 +228,8 @@ function createMouse(container) {
     container.appendChild(mouse);
 }
 
-// initialize halloween
 function initializeHalloween() {
-  if (!halloween) return; // exit if halloween is disabled
+  if (!halloween) return;
   createHalloween();
   toggleHalloween();
 
@@ -262,7 +254,7 @@ function initializeHalloween() {
   }
 
   const screenWidth = window.innerWidth; // get the screen width to detect mobile devices
-  if (randomSymbols && (screenWidth > 768 || randomSymbolsMobile)) { // add random halloweens only on larger screens, unless enabled for mobile devices
+  if (randomSymbols && (screenWidth > 768 || randomSymbolsMobile)) {
     addRandomSymbols(halloweenCount);
   }
 }

Jellyfin.Plugin.Seasonals/Web/hearts.js

@@ -1,10 +1,10 @@
 const config = window.SeasonalsPluginConfig?.Hearts || {};
 
 const hearts = config.EnableHearts !== undefined ? config.EnableHearts : true; // enable/disable hearts
-const randomSymbols = config.EnableRandomSymbols !== undefined ? config.EnableRandomSymbols : true; // enable more random symbols
-const randomSymbolsMobile = config.EnableRandomSymbolsMobile !== undefined ? config.EnableRandomSymbolsMobile : false; // enable random symbols on mobile devices (Warning: High values may affect performance)
-const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different animation duration for random symbols
-const heartsCount = config.SymbolCount || 25; // count of random extra symbols
+const randomSymbols = config.EnableRandomSymbols !== undefined ? config.EnableRandomSymbols : true; // enable random symbols
+const randomSymbolsMobile = config.EnableRandomSymbolsMobile !== undefined ? config.EnableRandomSymbolsMobile : false; // enable random symbols on mobile
+const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
+const heartsCount = config.SymbolCount !== undefined ? config.SymbolCount : 25; // count of symbol
 
 // Array of hearts characters
 const heartSymbols = ['❤️', '💕', '💞', '💓', '💗', '💖'];

Jellyfin.Plugin.Seasonals/Web/marioday.js

@@ -1,5 +1,9 @@
 const config = window.SeasonalsPluginConfig?.MarioDay || {};
-const marioday = config.EnableMarioDay !== undefined ? config.EnableMarioDay : true;
+const marioday = config.EnableMarioDay !== undefined ? config.EnableMarioDay : true; // enable/disable marioday
+const letMarioJump = config.LetMarioJump !== undefined ? config.LetMarioJump : true; // optionally let mario jump occasionally
+
+// Credit: https://gifs.alphacoders.com/gifs/view/2585
+const marioImage = '../Seasonals/Resources/mario_assets/mario.gif';
 
 let msgPrinted = false;
 
@@ -45,20 +49,38 @@ function createMarioDay(container) {
 
     const mario = document.createElement('img');
     mario.className = 'mario-runner';
-    mario.src = '../Seasonals/Resources/mario_assets/mario.gif';
+    mario.src = marioImage;
     
     wrapper.appendChild(mario);
     container.appendChild(wrapper);
     
+    let jumpCount = 0;
+    let maxJumpsForThisRun = Math.floor(Math.random() * 3); // 0, 1, or 2
+
+    const resetJumpInterval = setInterval(() => {
+        if (!document.body.contains(container)) { clearInterval(resetJumpInterval); return; }
+        jumpCount = 0;
+        maxJumpsForThisRun = Math.floor(Math.random() * 3); // Randomize jumps for the next pass
+    }, (marioSpeedSeconds / 2) * 1000);
+
     // Periodically throw out an 8-bit coin
     const intervalId = setInterval(() => {
         if (!document.body.contains(container)) { clearInterval(intervalId); return; }
         if (container.style.display === 'none') return;
+
+        const marioRect = wrapper.getBoundingClientRect();
+        if (marioRect.left < 0 || marioRect.right > window.innerWidth) return;
+
+        if (letMarioJump && !mario.classList.contains('mario-jump') && jumpCount < maxJumpsForThisRun) {
+            mario.classList.add('mario-jump');
+            jumpCount++;
+            setTimeout(() => mario.classList.remove('mario-jump'), 800);
+        }
+
         const coin = document.createElement('div');
         coin.className = 'mario-coin';
         
         // Grab Mario's current screen position to lock the coin's X coordinate
-        const marioRect = wrapper.getBoundingClientRect();
         coin.style.left = `${marioRect.left + 16}px`;
         coin.style.bottom = '35px'; // bottom offset
         

Jellyfin.Plugin.Seasonals/Web/matrix.js

@@ -1,9 +1,9 @@
 const config = window.SeasonalsPluginConfig?.Matrix || {};
 
-const enabled = config.EnableMatrix !== undefined ? config.EnableMatrix : true;
-const maxTrails = config.SymbolCount || 25; 
-const backgroundMode = config.EnableMatrixBackground !== undefined ? config.EnableMatrixBackground : false;
-const matrixChars = config.MatrixChars || '0123456789';
+const enabled = config.EnableMatrix !== undefined ? config.EnableMatrix : true; // enable/disable matrix
+const maxTrails = config.SymbolCount !== undefined ? config.SymbolCount : 25; // count of max trails on screen
+const backgroundMode = config.EnableMatrixBackground !== undefined ? config.EnableMatrixBackground : false; // enable/disable matrix as background
+const matrixChars = config.MatrixChars !== undefined ? config.MatrixChars : '0123456789'; // characters to use in the matrix rain, default is '0123456789'
 
 let msgPrinted = false;
 let isHidden = false;

Jellyfin.Plugin.Seasonals/Web/oktoberfest.js

@@ -1,5 +1,8 @@
 const config = window.SeasonalsPluginConfig?.Oktoberfest || {};
-const oktoberfest = config.EnableOktoberfest !== undefined ? config.EnableOktoberfest : true;
+const oktoberfest = config.EnableOktoberfest !== undefined ? config.EnableOktoberfest : true; // enable/disable oktoberfest
+const symbolCount = config.SymbolCount !== undefined ? config.SymbolCount : 25; // count of symbols
+const symbolCountMobile = config.SymbolCountMobile !== undefined ? config.SymbolCountMobile : 10; // count of symbols on mobile
+const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
 
 const oktoberfestSymbols = ['🥨', '🍺', '🍻', '🥨', '🥨'];
 
@@ -31,7 +34,6 @@ function toggleOktoberfest() {
   }
 }
 
-// observe changes in the DOM
 const observer = new MutationObserver(toggleOktoberfest);
 observer.observe(document.body, {
   childList: true,
@@ -39,8 +41,8 @@ observer.observe(document.body, {
   attributes: true
 });
 
-function createOktoberfest(container) {
-    for (let i = 0; i < 20; i++) {
+function createOktoberfest(container, count) {
+    for (let i = 0; i < count; i++) {
         const symbol = document.createElement('div');
         symbol.className = 'oktoberfest-symbol';
         symbol.textContent = oktoberfestSymbols[Math.floor(Math.random() * oktoberfestSymbols.length)];
@@ -48,7 +50,9 @@ function createOktoberfest(container) {
         symbol.style.animationDelay = `${Math.random() * 10}s, ${Math.random() * 5}s`;
         const duration1 = Math.random() * 5 + 8;
         const duration2 = Math.random() * 3 + 3;
-        symbol.style.animationDuration = `${duration1}s, ${duration2}s`;
+        if (enableDifferentDuration) {
+            symbol.style.animationDuration = `${duration1}s, ${duration2}s`;
+        }
         
         container.appendChild(symbol);
     }
@@ -62,6 +66,10 @@ function initializeOktoberfest() {
         container.setAttribute("aria-hidden", "true");
         document.body.appendChild(container);
     }
-    createOktoberfest(container);
+    
+    const screenWidth = window.innerWidth;
+    const count = screenWidth > 768 ? symbolCount : symbolCountMobile;
+
+    createOktoberfest(container, count);
 }
 initializeOktoberfest();

Jellyfin.Plugin.Seasonals/Web/oscar.js

@@ -1,5 +1,5 @@
 const config = window.SeasonalsPluginConfig?.Oscar || {};
-const oscar = config.EnableOscar !== undefined ? config.EnableOscar : true;
+const oscar = config.EnableOscar !== undefined ? config.EnableOscar : true; // enable/disable oscar
 
 let msgPrinted = false;
 

Jellyfin.Plugin.Seasonals/Web/pride.js

@@ -1,9 +1,9 @@
 const config = window.SeasonalsPluginConfig?.Pride || {};
 
-const enabled = config.EnablePride !== undefined ? config.EnablePride : true;
-const elementCount = config.HeartCount || 20;
-const heartSize = config.HeartSize || 1.5;
-const colorHeader = config.ColorHeader !== undefined ? config.ColorHeader : true;
+const enabled = config.EnablePride !== undefined ? config.EnablePride : true; // enable/disable pride
+const elementCount = config.HeartCount !== undefined ? config.HeartCount : 20; // count of heart
+const heartSize = config.HeartSize !== undefined ? config.HeartSize : 1.5; // size of hearts
+const colorHeader = config.ColorHeader !== undefined ? config.ColorHeader : true; // optionally color the header with pride colors
 
 let msgPrinted = false;
 

Jellyfin.Plugin.Seasonals/Web/rain.js

@@ -1,9 +1,9 @@
 const config = window.SeasonalsPluginConfig?.Rain || {};
 
-const enabled = config.EnableRain !== undefined ? config.EnableRain : true;
+const enabled = config.EnableRain !== undefined ? config.EnableRain : true; // enable/disable rain
 const isMobile = window.innerWidth <= 768;
-const elementCount = isMobile ? (config.RaindropCountMobile || 150) : (config.RaindropCount || 300);
-const rainSpeed = config.RainSpeed || 1.0;
+const elementCount = isMobile ? (config.RaindropCountMobile || 150) : (config.RaindropCount || 300); // count of raindrops
+const rainSpeed = config.RainSpeed !== undefined ? config.RainSpeed : 1.0; // speed of rain
 
 let msgPrinted = false;
 

Jellyfin.Plugin.Seasonals/Web/resurrection.js

@@ -1,10 +1,10 @@
 const config = window.SeasonalsPluginConfig?.Resurrection || {};
 
-const enableResurrection = config.EnableResurrection !== undefined ? config.EnableResurrection : true;
-const enableRandomSymbols = config.EnableRandomSymbols !== undefined ? config.EnableRandomSymbols : true;
-const enableRandomSymbolsMobile = config.EnableRandomSymbolsMobile !== undefined ? config.EnableRandomSymbolsMobile : false;
-const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true;
-const symbolCount = config.SymbolCount || 12;
+const enableResurrection = config.EnableResurrection !== undefined ? config.EnableResurrection : true; // enable/disable resurrection
+const enableRandomSymbols = config.EnableRandomSymbols !== undefined ? config.EnableRandomSymbols : true; // enable random symbols
+const enableRandomSymbolsMobile = config.EnableRandomSymbolsMobile !== undefined ? config.EnableRandomSymbolsMobile : false; // enable random symbols on mobile
+const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
+const symbolCount = config.SymbolCount !== undefined ? config.SymbolCount : 12; // count of symbols
 
 let animationEnabled = true;
 let statusLogged = false;

Jellyfin.Plugin.Seasonals/Web/santa.js

@@ -1,15 +1,15 @@
 const config = window.SeasonalsPluginConfig?.Santa || {};
 
 const santaIsFlying = config.EnableSanta !== undefined ? config.EnableSanta : true; // enable/disable santa
-let snowflakesCount = config.SnowflakesCount || 500; // count of snowflakes (recommended values: 300-600)
-const snowflakesCountMobile = config.SnowflakesCountMobile || 250; // count of snowflakes on mobile devices (Warning: High values may affect performance)
-const snowFallSpeed = config.SnowFallSpeed || 3; // speed of snowfall	(recommended values: 0-5)
-const santaSpeed = config.SantaSpeed || 10; // speed of santa in seconds (recommended values: 5-15)
-const santaSpeedMobile = config.SantaSpeedMobile || 8; // speed of santa on mobile devices in seconds
-const maxSantaRestTime = config.MaxSantaRestTime || 8; // maximum time santa rests in seconds
-const minSantaRestTime = config.MinSantaRestTime || 3; // minimum time santa rests in seconds
-const maxPresentFallSpeed = config.MaxPresentFallSpeed || 5; // maximum speed of falling presents in seconds
-const minPresentFallSpeed = config.MinPresentFallSpeed || 2; // minimum speed of falling presents in seconds
+let snowflakesCount = config.SnowflakesCount !== undefined ? config.SnowflakesCount : 500; // count of snowflakes
+const snowflakesCountMobile = config.SnowflakesCountMobile !== undefined ? config.SnowflakesCountMobile : 250; // count of snowflakes on mobile
+const snowFallSpeed = config.SnowFallSpeed !== undefined ? config.SnowFallSpeed : 3; // speed of snowfall
+const santaSpeed = config.SantaSpeed !== undefined ? config.SantaSpeed : 10; // speed of santa in seconds
+const santaSpeedMobile = config.SantaSpeedMobile !== undefined ? config.SantaSpeedMobile : 8; // speed of santa on mobile devices in seconds
+const maxSantaRestTime = config.MaxSantaRestTime !== undefined ? config.MaxSantaRestTime : 8; // maximum time santa rests in seconds
+const minSantaRestTime = config.MinSantaRestTime !== undefined ? config.MinSantaRestTime : 3; // minimum time santa rests in seconds
+const maxPresentFallSpeed = config.MaxPresentFallSpeed !== undefined ? config.MaxPresentFallSpeed : 5; // maximum speed of falling presents in seconds
+const minPresentFallSpeed = config.MinPresentFallSpeed !== undefined ? config.MinPresentFallSpeed : 2; // minimum speed of falling presents in seconds
 
 // credits: flaticon.com
 const presentImages = [

Jellyfin.Plugin.Seasonals/Web/snowfall.js

@@ -1,9 +1,9 @@
 const config = window.SeasonalsPluginConfig?.Snowfall || {};
 
 const snowfall = config.EnableSnowfall !== undefined ? config.EnableSnowfall : true; // enable/disable snowfall
-let snowflakesCount = config.SnowflakesCount || 500; // count of snowflakes (recommended values: 300-600)
-const snowflakesCountMobile = config.SnowflakesCountMobile || 250; // count of snowflakes on mobile devices (Warning: High values may affect performance)
-const snowFallSpeed = config.Speed || 3; // speed of snowfall	(recommended values: 0-5)
+let snowflakesCount = config.SnowflakesCount !== undefined ? config.SnowflakesCount : 500; // count of snowflakes
+const snowflakesCountMobile = config.SnowflakesCountMobile !== undefined ? config.SnowflakesCountMobile : 250; // count of snowflakes on mobile
+const snowFallSpeed = config.Speed !== undefined ? config.Speed : 3; // speed of snowfall
 
 let msgPrinted = false; // flag to prevent multiple console messages
 

Jellyfin.Plugin.Seasonals/Web/snowflakes.js

@@ -1,11 +1,11 @@
 const config = window.SeasonalsPluginConfig?.Snowflakes || {};
 
 const snowflakes = config.EnableSnowflakes !== undefined ? config.EnableSnowflakes : true; // enable/disable snowflakes
-const randomSnowflakes = config.EnableRandomSnowflakes !== undefined ? config.EnableRandomSnowflakes : true; // enable random Snowflakes
-const randomSnowflakesMobile = config.EnableRandomSnowflakesMobile !== undefined ? config.EnableRandomSnowflakesMobile : false; // enable random Snowflakes on mobile devices
-const enableColoredSnowflakes = config.EnableColoredSnowflakes !== undefined ? config.EnableColoredSnowflakes : true; // enable colored snowflakes
-const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different animation duration
-const snowflakeCount = config.SnowflakeCount || 25; // count of random extra snowflakes
+const snowflakeCount = config.SnowflakeCount !== undefined ? config.SnowflakeCount : 25; // count of snowflakes
+const randomSnowflakes = config.EnableRandomSnowflakes !== undefined ? config.EnableRandomSnowflakes : true; // enable random snowflakes
+const randomSnowflakesMobile = config.EnableRandomSnowflakesMobile !== undefined ? config.EnableRandomSnowflakesMobile : false; // enable random snowflakes on mobile
+const enableColoredSnowflakes = config.EnableColoredSnowflakes !== undefined ? config.EnableColoredSnowflakes : true; // enable/disable colored snowflakes
+const enableDiffrentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
 
 const snowflakeSymbols = ['❅', '❆']; // some snowflake symbols
 const snowflakeSymbolsMobile = ['❅', '❆', '❄']; // some snowflake symbols mobile version

Jellyfin.Plugin.Seasonals/Web/snowstorm.js

@@ -1,11 +1,11 @@
 const config = window.SeasonalsPluginConfig?.Snowstorm || {};
 
 const snowstorm = config.EnableSnowstorm !== undefined ? config.EnableSnowstorm : true; // enable/disable snowstorm
-let snowflakesCount = config.SnowflakesCount || 500; // count of snowflakes (recommended values: 300-600)
-const snowflakesCountMobile = config.SnowflakesCountMobile || 250; // count of snowflakes on mobile devices (Warning: High values may affect performance)
-const snowFallSpeed = config.Speed || 6; // speed of snowfall	(recommended values: 4-8)
-const horizontalWind = config.HorizontalWind || 4; // horizontal wind speed (recommended value: 4)
-const verticalVariation = config.VerticalVariation || 2; // vertical variation (recommended value: 2)
+let snowflakesCount = config.SnowflakesCount !== undefined ? config.SnowflakesCount : 500; // count of snowflakes
+const snowflakesCountMobile = config.SnowflakesCountMobile !== undefined ? config.SnowflakesCountMobile : 250; // count of snowflakes on mobile
+const snowFallSpeed = config.Speed !== undefined ? config.Speed : 6; // speed of snowstorm
+const horizontalWind = config.HorizontalWind !== undefined ? config.HorizontalWind : 4; // horizontal wind strength
+const verticalVariation = config.VerticalVariation !== undefined ? config.VerticalVariation : 2; // vertical variation
 
 let msgPrinted = false; // flag to prevent multiple console messages
 

Jellyfin.Plugin.Seasonals/Web/space.js

@@ -1,18 +1,20 @@
 const config = window.SeasonalsPluginConfig?.Space || {};
 
-const space = config.EnableSpace !== undefined ? config.EnableSpace : true;
-const planetCountConf = config.PlanetCount !== undefined ? config.PlanetCount : 6;
-const astronautCountConf = config.AstronautCount !== undefined ? config.AstronautCount : 1;
-const satelliteCountConf = config.SatelliteCount !== undefined ? config.SatelliteCount : 4;
-const issCountConf = config.IssCount !== undefined ? config.IssCount : 1;
-const rocketCountConf = config.RocketCount !== undefined ? config.RocketCount : 1;
-const useRandomSymbols = config.EnableRandomSymbols !== undefined ? config.EnableRandomSymbols : true;
-const enableRandomMobile = config.EnableRandomSymbolsMobile !== undefined ? config.EnableRandomSymbolsMobile : false;
-const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true;
+const space = config.EnableSpace !== undefined ? config.EnableSpace : true; // enable/disable space
+const planetCountConf = config.PlanetCount !== undefined ? config.PlanetCount : 6; // count of planets
+const astronautCountConf = config.AstronautCount !== undefined ? config.AstronautCount : 1; // count of astronaut
+const satelliteCountConf = config.SatelliteCount !== undefined ? config.SatelliteCount : 4; // count of satellite
+const issCountConf = config.IssCount !== undefined ? config.IssCount : 1; // count of iss
+const rocketCountConf = config.RocketCount !== undefined ? config.RocketCount : 1; // count of rocket/space shuttle
+const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
+const symbolCountMobile = config.SymbolCountMobile !== undefined ? config.SymbolCountMobile : 2; // Devisor to reduce number of objects on mobile
 
+// Credit: https://lottiefiles.com/free-animation/astronaut-63lcWG4Xnh
 const astronautImages = [
     "../Seasonals/Resources/space_assets/astronaut_1.gif"
 ];
+
+// Credits: https://flaticon.com
 const planetImages = [
     "../Seasonals/Resources/space_assets/planet_1.png",
     "../Seasonals/Resources/space_assets/planet_2.png",
@@ -24,13 +26,21 @@ const planetImages = [
     "../Seasonals/Resources/space_assets/planet_8.png",
     "../Seasonals/Resources/space_assets/planet_9.png"
 ];
+
+// Credits: https://lottiefiles.com/free-animation/s-satellite-vfnNE8AALo
 const satelliteImages = [
     "../Seasonals/Resources/space_assets/Satellite_1.gif",
     "../Seasonals/Resources/space_assets/Satellite_2.gif"
 ];
 
+// Credit: https://pixabay.com/de/illustrations/raumstation-raum-struktur-8023777/
 const issImage = "../Seasonals/Resources/space_assets/iss.png";
 
+/**
+ * Credits:
+ * https://lottiefiles.com/free-animation/rocket-MYUQ3UFq3k
+ * https://pixabay.com/de/vectors/space-shuttle-atlantis-nasa-156012/
+ */
 const rocketImages = [
     "../Seasonals/Resources/space_assets/rocket.gif",
     "../Seasonals/Resources/space_assets/space-shuttle.png"
@@ -78,26 +88,19 @@ function createSpace() {
         document.body.appendChild(container);
     }
 
-    const standardPlanetCount = 4;
-    const standardAstronautCount = 1;
-    const standardSatelliteCount = 2;
-    const standardIssCount = 1;
-    const standardRocketCount = 1;
+    // const standardPlanetCount = 4;
+    // const standardAstronautCount = 1;
+    // const standardSatelliteCount = 2;
+    // const standardIssCount = 1;
+    // const standardRocketCount = 1;
 
     let isMobile = window.matchMedia("only screen and (max-width: 768px)").matches;
-    let pCount = planetCountConf;
-    let aCount = astronautCountConf;
-    let sCount = satelliteCountConf;
-    let iCount = issCountConf;
-    let rCount = rocketCountConf;
-
-    if (isMobile && !enableRandomMobile) {
-        pCount = standardPlanetCount;
-        aCount = standardAstronautCount;
-        sCount = standardSatelliteCount;
-        iCount = standardIssCount;
-        rCount = standardRocketCount;
-    }
+    let divisor = isMobile ? Math.max(1, symbolCountMobile) : 1;
+    let pCount = Math.floor(planetCountConf / divisor);
+    let aCount = Math.floor(astronautCountConf / divisor);
+    let sCount = Math.floor(satelliteCountConf / divisor);
+    let iCount = Math.floor(issCountConf / divisor);
+    let rCount = Math.floor(rocketCountConf / divisor);
 
     // Add Nebula Glow
     const bgGlow = document.createElement('div');

Jellyfin.Plugin.Seasonals/Web/spooky.js

@@ -1,11 +1,17 @@
 const config = window.SeasonalsPluginConfig?.Spooky || {};
 
-const spooky = config.EnableSpooky !== undefined ? config.EnableSpooky : true; // enable/disable
-const spookyCount = config.SymbolCount || 25; // count of random extra symbols
-const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true;
-const enableSpookySway = config.EnableSpookySway !== undefined ? config.EnableSpookySway : true;
-const spookySize = config.SpookySize || 20;
-const spookyGlowSize = config.SpookyGlowSize !== undefined ? config.SpookyGlowSize : 2;
+const spooky = config.EnableSpooky !== undefined ? config.EnableSpooky : true; // enable/disable spooky
+const spookyCount = config.SymbolCount !== undefined ? config.SymbolCount : 25; // count of symbols
+const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
+const enableSpookySway = config.EnableSpookySway !== undefined ? config.EnableSpookySway : true; // enable/disable spooky sway
+const spookySize = config.SpookySize !== undefined ? config.SpookySize : 20; // size of elements
+const spookyGlowSize = config.SpookyGlowSize !== undefined ? config.SpookyGlowSize : 2; // size of element glow
+
+const spookyImages = [
+  "../Seasonals/Resources/halloween_images/ghost_20x20.png",
+  "../Seasonals/Resources/halloween_images/bat_20x20.png",
+  "../Seasonals/Resources/halloween_images/pumpkin_20x20.png",
+];
 
 let msgPrinted = false;
 
@@ -20,13 +26,13 @@ function toggleSpooky() {
   const hasUserMenu = document.querySelector('#app-user-menu');
 
   if (videoPlayer || trailerPlayer || isDashboard || hasUserMenu) {
-    spookyContainer.style.display = 'none'; // hide spooky
+    spookyContainer.style.display = 'none';
     if (!msgPrinted) {
       console.log('Spooky Theme hidden');
       msgPrinted = true;
     }
   } else {
-    spookyContainer.style.display = 'block'; // show spooky
+    spookyContainer.style.display = 'block';
     if (msgPrinted) {
       console.log('Spooky Theme visible');
       msgPrinted = false;
@@ -34,7 +40,6 @@ function toggleSpooky() {
   }
 }
 
-// observe changes in the DOM
 const observer = new MutationObserver(toggleSpooky);
 observer.observe(document.body, {
   childList: true,
@@ -42,13 +47,7 @@ observer.observe(document.body, {
   attributes: true
 });
 
-const spookyImages = [
-  "../Seasonals/Resources/halloween_images/ghost_20x20.png",
-  "../Seasonals/Resources/halloween_images/bat_20x20.png",
-  "../Seasonals/Resources/halloween_images/pumpkin_20x20.png",
-];
 
-// create spooky objects
 function createSpooky() {
   const container = document.querySelector('.spooky-container') || document.createElement("div");
 
@@ -95,7 +94,6 @@ function createSpooky() {
     });
   }
 
-  // Add configured extra symbols
   for (let i = 0; i < spookyCount; i++) {
     const spookyOuter = document.createElement("div");
     spookyOuter.className = "spooky";

Jellyfin.Plugin.Seasonals/Web/sports.js

@@ -1,29 +1,30 @@
 const config = window.SeasonalsPluginConfig?.Sports || {};
 
-const sports = config.EnableSports !== undefined ? config.EnableSports : true;
-const symbolCount = config.SymbolCount || 5;
-const useRandomSymbols = config.EnableRandomSymbols !== undefined ? config.EnableRandomSymbols : true;
-const enableRandomMobile = config.EnableRandomSymbolsMobile !== undefined ? config.EnableRandomSymbolsMobile : false;
-const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true;
-const enableTrophy = config.EnableTrophy !== undefined ? config.EnableTrophy : false;
+const sports = config.EnableSports !== undefined ? config.EnableSports : true; // enable/disable sports
+const symbolCount = config.SymbolCount !== undefined ? config.SymbolCount : 5; // count of balls per category
+const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
+const enableTrophy = config.EnableTrophy !== undefined ? config.EnableTrophy : false; // enable/disable trophy
+const rawSportsBalls = config.SportsBalls !== undefined ? config.SportsBalls : 'football,basketball,tennis,volleyball'; // set sports categories to spawn
+const turfColorHex = config.TurfColor !== undefined ? config.TurfColor : '#228b22'; // color of turf
+const confettiColors = config.ConfettiColors ? config.ConfettiColors.split(',') : ['#000000', '#FF0000', '#FFCC00']; // Add Country Colored confetti
 
 // Pre-declare and manage image assets
+// Credits: https://flaticon.com
 const SPORTS_ASSETS = {
-  badminton: ['badminton_1', 'badminton_2'],
-  baseball: ['baseball_1', 'baseball_2'],
-  basketball: ['basketball_1', 'basketball_2'],
-  billiard: Array.from({length: 14}, (_, i) => `billiard_ball_${i + 1}`),
-  bowling: ['bowling_1', 'bowling_2'],
-  football: Array.from({length: 5}, (_, i) => `football_${i + 1}`),
-  golf: ['golf_ball_1', 'golf_ball_2'],
-  rugby: ['rugby_ball_1', 'rugby_ball_2'],
-  table_tennis: ['table_tennis_ball_1', 'table_tennis_ball_2'],
-  tennis: ['tennis_ball_1', 'tennis_ball_2'],
-  volleyball: ['volleyball_1', 'volleyball_2'],
-  waterball: ['waterball_1', 'waterball_2']
+    badminton: ['badminton_1', 'badminton_2'],
+    baseball: ['baseball_1', 'baseball_2'],
+    basketball: ['basketball_1', 'basketball_2'],
+    billiard: Array.from({length: 14}, (_, i) => `billiard_ball_${i + 1}`),
+    bowling: ['bowling_1', 'bowling_2'],
+    football: Array.from({length: 5}, (_, i) => `football_${i + 1}`),
+    golf: ['golf_ball_1', 'golf_ball_2'],
+    rugby: ['rugby_ball_1', 'rugby_ball_2'],
+    table_tennis: ['table_tennis_ball_1', 'table_tennis_ball_2'],
+    tennis: ['tennis_ball_1', 'tennis_ball_2'],
+    volleyball: ['volleyball_1', 'volleyball_2'],
+    waterball: ['waterball_1', 'waterball_2']
 };
 
-const turfColorHex = config.TurfColor || '#228b22';
 
 let msgPrinted = false;
 
@@ -67,11 +68,10 @@ function createSports() {
         document.body.appendChild(container);
     }
 
-    // Parse turf color config
     // Create a turf/grass overlay at the bottom using the provided hex
     const turf = document.createElement('div');
     turf.className = 'sports-turf';
-    // Using hex with transparency (e.g., 4D = 30%, CC = 80%)
+    // Using hex with transparency
     turf.style.background = `linear-gradient(180deg, transparent 0%, ${turfColorHex}4D 30%, ${turfColorHex}CC 100%)`;
     container.appendChild(turf);
 
@@ -85,7 +85,6 @@ function createSports() {
     const useRandomDuration = enableDifferentDuration !== false;
 
     // Map standard sports balls to spawn based on category configuration
-    const rawSportsBalls = config.SportsBalls || 'football,basketball,tennis,volleyball';
     const chosenCategories = rawSportsBalls.split(',').map(s => s.trim()).filter(s => s !== '');
 
     const createBall = (randomItem) => {
@@ -140,7 +139,7 @@ function createSports() {
     // Create falling sports balls
     chosenCategories.forEach(category => {
         let variants = SPORTS_ASSETS[category];
-        if (!variants) variants = [category]; // Legacy fallback
+        if (!variants) variants = [category];
         
         for (let i = 0; i < ballsPerCategory; i++) {
             // Pick a random variant
@@ -162,7 +161,6 @@ function createSports() {
         
         let trophyImg = document.createElement('img');
         trophyImg.src = `../Seasonals/Resources/sport_assets/trophy.gif`;
-        // Randomly scale trophy slightly larger
         trophyImg.style.transform = `scale(${Math.random() * 0.5 + 0.8})`;
         trophyImg.onerror = function() {
             this.style.display = 'none';
@@ -211,8 +209,6 @@ function createSports() {
         setTimeout(() => { if (document.body.contains(container)) launchTrophy(); }, Math.random() * 5000 + 2000);
     }
 
-    // Add Germany Colored confetti (Black, Red, Gold)
-    const confettiColors = ['#000000', '#FF0000', '#FFCC00'];
     const confettiCount = isMobile ? 30 : 60;
     
     for (let i = 0; i < confettiCount; i++) {
@@ -257,8 +253,6 @@ function createSports() {
     }
 }
 
-/* Removed legacy fallback logic */
-
 function initializeSports() {
   if (!sports) return;
   createSports();

Jellyfin.Plugin.Seasonals/Web/spring.js

@@ -1,14 +1,14 @@
 const config = window.SeasonalsPluginConfig?.Spring || {};
 
-const spring = config.EnableSpring !== undefined ? config.EnableSpring : true; // Enable/disable spring
-const pollenCount = config.PollenCount || 30; // Number of pollen particles
-const sunbeamCount = config.SunbeamCount || 5; // Number of sunbeams
-const enableSunbeams = config.EnableSpringSunbeams !== undefined ? config.EnableSpringSunbeams : true; // Enable/disable sunbeams
-const birdCount = config.BirdCount !== undefined ? config.BirdCount : 3; // Number of birds
-const butterflyCount = config.ButterflyCount !== undefined ? config.ButterflyCount : 4; // Number of butterflies
-const beeCount = config.BeeCount !== undefined ? config.BeeCount : 2; // Number of bees
-const ladybugCount = config.LadybugCount !== undefined ? config.LadybugCount : 2; // Number of ladybugs
-const randomSpring = config.EnableRandomSpring !== undefined ? config.EnableRandomSpring : true; // Enable random spring objects
+const spring = config.EnableSpring !== undefined ? config.EnableSpring : true; // enable/disable spring
+const pollenCount = config.PollenCount !== undefined ? config.PollenCount : 30; // count of pollen
+const enableSunbeams = config.EnableSpringSunbeams !== undefined ? config.EnableSpringSunbeams : true; // enable/disable sunbeams
+const sunbeamCount = config.SunbeamCount !== undefined ? config.SunbeamCount : 5; // count of sunbeams
+const birdCount = config.BirdCount !== undefined ? config.BirdCount : 3; // count of birds
+const butterflyCount = config.ButterflyCount !== undefined ? config.ButterflyCount : 4; // count of butterflies
+const beeCount = config.BeeCount !== undefined ? config.BeeCount : 2; // count of bees
+const ladybugCount = config.LadybugCount !== undefined ? config.LadybugCount : 2; // count of ladybugs
+const symbolCountMobile = config.SymbolCountMobile !== undefined ? config.SymbolCountMobile : 2; // Devisor to reduce number of objects on mobile
 
 // Credit: https://lottiefiles.com/free-animation/birds-flying-V7O0L8jkOg
 const birdImages = [
@@ -23,7 +23,10 @@ const butterflyImages = [
     '../Seasonals/Resources/spring_assets/Butterfly_2.gif'
 ];
 
+// Credit: https://lottiefiles.com/free-animation/loading-flying-beee-WcTfIccdJZ
 const beeImage = '../Seasonals/Resources/spring_assets/Bee.gif';
+
+// Credit: https://pixabay.com/gifs/ladybug-insect-nature-fly-wings-5068/
 const ladybugImage = '../Seasonals/Resources/spring_assets/ladybug.gif';
 
 let msgPrinted = false;
@@ -230,28 +233,35 @@ function initializeSpring() {
 
     const container = document.querySelector('.spring-container');
     if (container) {
-        if (randomSpring) {
-            // Add Pollen
-            for (let i = 0; i < pollenCount; i++) {
-                createPollen(container);
-            }
+        let isMobile = window.matchMedia("only screen and (max-width: 768px)").matches;
+        let divisor = isMobile ? Math.max(1, symbolCountMobile) : 1;
 
-            // Add Birds
-            for (let i = 0; i < birdCount; i++) {
-                setTimeout(() => createBird(container), Math.random() * 1000); // 0-1s desync
-            }
-            // Add Butterflies
-            for (let i = 0; i < butterflyCount; i++) {
-                setTimeout(() => createButterfly(container), Math.random() * 1000); // 0-1s desync
-            }
-            // Add Bees
-            for (let i = 0; i < beeCount; i++) {
-                setTimeout(() => createBee(container), Math.random() * 1000); // 0-1s desync
-            }
-            // Add Ladybugs
-            for (let i = 0; i < ladybugCount; i++) {
-                setTimeout(() => createLadybugGif(container), Math.random() * 1000); // 0-1s desync
-            }
+        let adjPollen = Math.floor(pollenCount / divisor);
+        let adjBird = Math.floor(birdCount / divisor);
+        let adjButterfly = Math.floor(butterflyCount / divisor);
+        let adjBee = Math.floor(beeCount / divisor);
+        let adjLadybug = Math.floor(ladybugCount / divisor);
+
+        // Add Pollen
+        for (let i = 0; i < adjPollen; i++) {
+            createPollen(container);
+        }
+
+        // Add Birds
+        for (let i = 0; i < adjBird; i++) {
+            setTimeout(() => createBird(container), Math.random() * 1000); // 0-1s desync
+        }
+        // Add Butterflies
+        for (let i = 0; i < adjButterfly; i++) {
+            setTimeout(() => createButterfly(container), Math.random() * 1000); // 0-1s desync
+        }
+        // Add Bees
+        for (let i = 0; i < adjBee; i++) {
+            setTimeout(() => createBee(container), Math.random() * 1000); // 0-1s desync
+        }
+        // Add Ladybugs
+        for (let i = 0; i < adjLadybug; i++) {
+            setTimeout(() => createLadybugGif(container), Math.random() * 1000); // 0-1s desync
         }
     }
 }

Jellyfin.Plugin.Seasonals/Web/starwars.js

@@ -1,5 +1,5 @@
 const config = window.SeasonalsPluginConfig?.StarWars || {};
-const starwars = config.EnableStarWars !== undefined ? config.EnableStarWars : true;
+const starwars = config.EnableStarWars !== undefined ? config.EnableStarWars : true; // enable/disable starwars
 
 let msgPrinted = false;
 

Jellyfin.Plugin.Seasonals/Web/storm.js

@@ -1,10 +1,10 @@
 const config = window.SeasonalsPluginConfig?.Storm || {};
 
-const enabled = config.EnableStorm !== undefined ? config.EnableStorm : true;
+const enabled = config.EnableStorm !== undefined ? config.EnableStorm : true; // enable/disable storm
 const isMobile = window.innerWidth <= 768;
-const elementCount = isMobile ? (config.RaindropCountMobile || 150) : (config.RaindropCount || 300);
-const enableLightning = config.EnableLightning !== undefined ? config.EnableLightning : true;
-const rainSpeed = config.RainSpeed || 1.0;
+const elementCount = isMobile ? (config.RaindropCountMobile || 150) : (config.RaindropCount || 300); // count of raindrops
+const enableLightning = config.EnableLightning !== undefined ? config.EnableLightning : true; // enable/disable lightning
+const rainSpeed = config.RainSpeed !== undefined ? config.RainSpeed : 1.0; // speed of rain
 
 let msgPrinted = false;
 

Jellyfin.Plugin.Seasonals/Web/summer.js

@@ -1,11 +1,10 @@
 const config = window.SeasonalsPluginConfig?.Summer || {};
 
-const summer = config.EnableSummer !== undefined ? config.EnableSummer : true; // Enable/disable summer theme
-const bubbleCount = config.BubbleCount || 30; // Number of bubbles
-const dustCount = config.DustCount || 50; // Number of dust particles
-const randomSummer = config.EnableRandomSummer !== undefined ? config.EnableRandomSummer : true; // Enable random generating objects
-const randomSummerMobile = config.EnableRandomSummerMobile !== undefined ? config.EnableRandomSummerMobile : false; // Enable random generating objects on mobile
-const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // Randomize animation duration of bubbles and dust
+const summer = config.EnableSummer !== undefined ? config.EnableSummer : true; // enable/disable summer
+const bubbleCount = config.BubbleCount !== undefined ? config.BubbleCount : 30; // count of bubbles
+const dustCount = config.DustCount !== undefined ? config.DustCount : 50; // count of dust particles
+const symbolCountMobile = config.SymbolCountMobile !== undefined ? config.SymbolCountMobile : 2; // Devisor to reduce number of objects on mobile
+const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
 
 let msgPrinted = false;
 
@@ -39,34 +38,23 @@ observer.observe(document.body, {
   subtree: true,
   attributes: true
 });
-function createBubble(container, isDust = false) {
+
+function createBubble(container) {
     const bubble = document.createElement('div');
-    
-    if (isDust) {
-        bubble.classList.add('summer-dust');
-    } else {
-        bubble.classList.add('summer-bubble');
-    }
+
+    bubble.classList.add('summer-bubble');
 
     // Random horizontal position
     const randomLeft = Math.random() * 100;
     bubble.style.left = `${randomLeft}%`;
 
-    // Random size
-    if (!isDust) {
-        // MARK: BUBBLE SIZE
-        const size = Math.random() * 20 + 10; // 10-30px bubbles
-        bubble.style.width = `${size}px`;
-        bubble.style.height = `${size}px`;
-    } else {
-        // MARK: DUST SIZE
-        const size = Math.random() * 3 + 1; // 1-4px dust
-        bubble.style.width = `${size}px`;
-        bubble.style.height = `${size}px`;
-    }
+    // MARK: BUBBLE SIZE
+    const size = Math.random() * 20 + 10; // 10-30px bubbles
+    bubble.style.width = `${size}px`;
+    bubble.style.height = `${size}px`;
 
     // Animation properties
-    const duration = isDust ? (Math.random() * 20 + 10) : (Math.random() * 10 + 5); // Dust is slower
+    const duration = (Math.random() * 10 + 5);
     const delay = Math.random() * 10;
     
     if (enableDifferentDuration) {
@@ -77,19 +65,30 @@ function createBubble(container, isDust = false) {
     container.appendChild(bubble);
 }
 
-function addRandomSummerObjects() {
-    const container = document.querySelector('.summer-container');
-    if (!container) return;
+function createDust(container) {
+    const dust = document.createElement('div');
+
+    dust.classList.add('summer-dust');
+
+    // Random horizontal position
+    const randomLeft = Math.random() * 100;
+    dust.style.left = `${randomLeft}%`;
+
+    // MARK: DUST SIZE
+    const size = Math.random() * 3 + 1; // 1-4px dust
+    dust.style.width = `${size}px`;
+    dust.style.height = `${size}px`;
+
+    // Animation properties
+    const duration = (Math.random() * 20 + 10); // Dust is slower
+    const delay = Math.random() * 10;
     
-    // Add bubbles
-    for (let i = 0; i < bubbleCount; i++) {
-        createBubble(container, false);
-    }
-    
-    // Add some dust particles
-    for (let i = 0; i < dustCount; i++) {
-        createBubble(container, true);
+    if (enableDifferentDuration) {
+        dust.style.animationDuration = `${duration}s`;
     }
+    dust.style.animationDelay = `${delay}s`;
+
+    container.appendChild(dust);
 }
 
 function initSummerObjects() {
@@ -101,38 +100,18 @@ function initSummerObjects() {
         document.body.appendChild(container);
     }
     
-    // Initial bubbles/dust
-    for (let i = 0; i < 10; i++) {
-        const bubble = document.createElement('div');
-        const isDust = Math.random() > 0.5;
-        if (isDust) {
-            bubble.classList.add('summer-dust');
-        } else {
-            bubble.classList.add('summer-bubble');
-        }
-        
-        const randomLeft = Math.random() * 100;
-        bubble.style.left = `${randomLeft}%`;
-        
-        if (!isDust) {
-            // MARK: BUBBLE SIZE
-            const size = Math.random() * 20 + 10;
-            bubble.style.width = `${size}px`;
-            bubble.style.height = `${size}px`;
-        } else {
-            // MARK: DUST SIZE
-            const size = Math.random() * 3 + 1;
-            bubble.style.width = `${size}px`;
-            bubble.style.height = `${size}px`;
-        }
-        
-        const duration = isDust ? (Math.random() * 20 + 10) : (Math.random() * 10 + 5);
-        if (enableDifferentDuration) {
-           bubble.style.animationDuration = `${duration}s`;
-        }
-        
-        bubble.style.animationDelay = `-${Math.random() * 10}s`;
-        container.appendChild(bubble);
+    let isMobile = window.matchMedia("only screen and (max-width: 768px)").matches;
+    let limitBubbles = isMobile ? Math.floor(bubbleCount / Math.max(1, symbolCountMobile)) : bubbleCount;
+    let limitDust = isMobile ? Math.floor(dustCount / Math.max(1, symbolCountMobile)) : dustCount;
+
+    // Initial bubbles
+    for (let i = 0; i < limitBubbles; i++) {
+        createBubble(container);
+    }
+    
+    // Initial dust
+    for (let i = 0; i < limitDust; i++) {
+        createDust(container);
     }
 }
 
@@ -140,11 +119,6 @@ function initializeSummer() {
     if (!summer) return;
     initSummerObjects();
     toggleSummer();
-
-    const screenWidth = window.innerWidth;
-    if (randomSummer && (screenWidth > 768 || randomSummerMobile)) {
-        addRandomSummerObjects();
-    }
 }
 
 initializeSummer();

Jellyfin.Plugin.Seasonals/Web/underwater.js

@@ -1,43 +1,63 @@
 const config = window.SeasonalsPluginConfig?.Underwater || {};
 
-const underwater = config.EnableUnderwater !== undefined ? config.EnableUnderwater : true;
-const symbolCount = config.SymbolCount || 15;
-const useRandomSymbols = config.EnableRandomSymbols !== undefined ? config.EnableRandomSymbols : true;
-const enableRandomMobile = config.EnableRandomSymbolsMobile !== undefined ? config.EnableRandomSymbolsMobile : false;
-const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true;
-const enableLightRays = config.EnableLightRays !== undefined ? config.EnableLightRays : true;
-const seaweedCount = config.SeaweedCount !== undefined ? config.SeaweedCount : 50;
+const underwater = config.EnableUnderwater !== undefined ? config.EnableUnderwater : true; // enable/disable underwater
+const symbolCountMobile = config.SymbolCountMobile !== undefined ? config.SymbolCountMobile : 2; // Devisor to reduce number of objects on mobile
+const enableDifferentDuration = config.EnableDifferentDuration !== undefined ? config.EnableDifferentDuration : true; // enable different durations
+const enableLightRays = config.EnableLightRays !== undefined ? config.EnableLightRays : true; // enable/disable lightrays
+const seaweedCount = config.SeaweedCount !== undefined ? config.SeaweedCount : 50; // count of seaweed
 
 // Entity counts configured
-const fishCount = config.FishCount !== undefined ? config.FishCount : 15;
-const seahorseCount = config.SeahorseCount !== undefined ? config.SeahorseCount : 3;
-const jellyfishCount = config.JellyfishCount !== undefined ? config.JellyfishCount : 3;
-const turtleCount = config.TurtleCount !== undefined ? config.TurtleCount : 1;
-const crabCount = config.CrabCount !== undefined ? config.CrabCount : 2;
-const starfishCount = config.StarfishCount !== undefined ? config.StarfishCount : 2;
-const shellCount = config.ShellCount !== undefined ? config.ShellCount : 2;
+const fishCount = config.FishCount !== undefined ? config.FishCount : 15; // count of fish
+const seahorseCount = config.SeahorseCount !== undefined ? config.SeahorseCount : 3; // count of seahorse
+const jellyfishCount = config.JellyfishCount !== undefined ? config.JellyfishCount : 3; // count of jellyfish
+const turtleCount = config.TurtleCount !== undefined ? config.TurtleCount : 1; // count of turtle
+const crabCount = config.CrabCount !== undefined ? config.CrabCount : 2; // count of crab
+const starfishCount = config.StarfishCount !== undefined ? config.StarfishCount : 2; // count of starfish
+const shellCount = config.ShellCount !== undefined ? config.ShellCount : 2; // count of shell
 
+// credits: https://lottiefiles.com/free-animation/seaweed-E6Go0HdkqY
 const seaweeds = [
     "../Seasonals/Resources/underwater_assets/seaweed_1.gif",
     "../Seasonals/Resources/underwater_assets/seaweed_2.gif"
 ];
 
-// Statics for bottom
+/**
+ * Credits:
+ * https://www.animierte-gifs.net/img-animiertes-krebs-bild-0041-59970.htm
+ * https://www.animierte-gifs.net/img-animiertes-krebs-bild-0002-59931.htm
+ * 
+ */
 const crabImages = [
     "../Seasonals/Resources/underwater_assets/crab_1.gif",
     "../Seasonals/Resources/underwater_assets/crab_2.gif",
     "../Seasonals/Resources/underwater_assets/crab_3.gif"
 ];
 
+/**
+ * Credits:
+ * https://lottiefiles.com/free-animation/dancing-starfish-tJ9ZFu9Zq0
+ * https://www.animierte-gifs.net/img-animiertes-fische-bild-0003-50003.htm
+ */
 const starfishImages = [
     "../Seasonals/Resources/underwater_assets/starfish_1.gif",
     "../Seasonals/Resources/underwater_assets/starfish_2.gif"
 ];
 
+// Credit: https://www.animierte-gifs.net/img-animiertes-muschel-bild-0021-108539.htm
 const shellImages = [
     "../Seasonals/Resources/underwater_assets/shell_1.gif"
 ];
 
+/**
+ * Credits:
+ * https://lottiefiles.com/free-animation/0101uwt-tt-01-4fA4Lm9gtN
+ * https://www.animierte-gifs.net/img-animiertes-fische-bild-0473-50473.htm
+ * https://www.animierte-gifs.net/img-animiertes-fische-bild-0290-50290.htm
+ * https://www.animierte-gifs.net/img-animiertes-fische-bild-0049-50049.htm
+ * https://www.animierte-gifs.net/img-animiertes-fische-bild-0403-50403.htm
+ * 
+ * https://flaticon.com
+ */
 const fishImages = [
     "../Seasonals/Resources/underwater_assets/fish_1.gif",
     "../Seasonals/Resources/underwater_assets/fish_2.gif",
@@ -55,15 +75,22 @@ const fishImages = [
     "../Seasonals/Resources/underwater_assets/fish_15.png"
 ];
 
+/**
+ * Credits:
+ * https://www.animierte-gifs.net/img-animiertes-fische-bild-0221-50221.htm
+ * https://www.animierte-gifs.net/img-animiertes-fische-bild-0217-50217.htm
+ */
 const seahorsesImages = [
     "../Seasonals/Resources/underwater_assets/seahorse_1.gif",
     "../Seasonals/Resources/underwater_assets/seahorse_2.gif"
 ];
 
+// credit: https://lottiefiles.com/free-animation/sea-turtle-s0sbHIWS2F
 const turtleImages = [
     "../Seasonals/Resources/underwater_assets/turtle.gif"
 ];
 
+// credits: https://lottiefiles.com/free-animation/jellyfish-wPwyF8EeSQ
 const jellyfishImages = [
     "../Seasonals/Resources/underwater_assets/jellyfish_1.gif",
     "../Seasonals/Resources/underwater_assets/jellyfish_2.gif"
@@ -137,16 +164,15 @@ function createUnderwater() {
     const useRandomDuration = enableDifferentDuration !== false;
     let isMobile = window.matchMedia("only screen and (max-width: 768px)").matches;
 
-
     // Seaweed swaying at the bottom (evenly distributed based on count)
-    const activeSeaweedCount = Math.max(1, seaweedCount);
+    const activeSeaweedCount = isMobile ? Math.max(1, Math.floor(seaweedCount / Math.max(1, symbolCountMobile))) : Math.max(1, seaweedCount);
     const seaweedSpacing = 95 / activeSeaweedCount;
-    for (let i = 0; i < seaweedCount; i++) {
+    for (let i = 0; i < activeSeaweedCount; i++) {
         let seaweed = document.createElement('div');
         seaweed.className = 'underwater-seaweed';
         seaweed.style.position = 'absolute';
         
-        // MARK: Distance from the bottom edge for the seaweed
+        // Distance from the bottom edge for the seaweed
         seaweed.style.bottom = '-18px';
         
         let offset = (Math.random() * seaweedSpacing) - (seaweedSpacing / 2);
@@ -163,7 +189,7 @@ function createUnderwater() {
         seaweed.style.transform = `scale(${scale}) ${flip}`;
         seaweed.style.zIndex = depth < 0.5 ? '15' : '30';
 
-        // Mix Emojis and GIFs
+        // Mix Emojis and GIFs for seaweed
         if (Math.random() > 0.4) {
             let img = document.createElement('img');
             img.src = seaweeds[Math.floor(Math.random() * seaweeds.length)];
@@ -182,9 +208,8 @@ function createUnderwater() {
 
     // Static Bottom Creatures logic
     function spawnStatic(imageArray, maxCount, baseSize) {
-        // Evaluate an actual count between 1 and maxCount if random symbols are enabled
-        const actualCount = (useRandomSymbols && maxCount > 0) ? Math.floor(Math.random() * maxCount) + 1 : maxCount;
-        for (let i = 0; i < actualCount; i++) {
+        let spawnLimit = isMobile ? Math.floor(maxCount / Math.max(1, symbolCountMobile)) : maxCount;
+        for (let i = 0; i < spawnLimit; i++) {
             let creature = document.createElement('div');
             creature.className = 'underwater-static-bottom';
             creature.style.position = 'absolute';
@@ -216,13 +241,9 @@ function createUnderwater() {
     // Swimmers logic
     function spawnSwimmerLoop(imageArray, maxCount, baseSize, typeName) {
         if (maxCount <= 0) return;
-        let spawnLimit = isMobile ? (enableRandomMobile ? maxCount : Math.floor(maxCount / 2)) : maxCount;
+        let spawnLimit = isMobile ? Math.floor(maxCount / Math.max(1, symbolCountMobile)) : maxCount;
         
-        // Randomize the actual amount spawned up to the limit
-        const actualCount = (useRandomSymbols && spawnLimit > 0) ? Math.floor(Math.random() * spawnLimit) + 1 : spawnLimit;
-        
-        for (let i = 0; i < actualCount; i++) {
-            // Spawn immediately but use negative delay to distribute them across the screen!
+        for (let i = 0; i < spawnLimit; i++) {
             spawnSingleSwimmer(imageArray, baseSize, typeName);
         }
     }