Merge pull request #367 from DevD4v3/feature/add-gungame-wins

Add GunGame wins as a persistent player statistic.

Changes:
* Added the GunGameWins statistic to PlayerInfo.
* Persisted the statistic across all repository implementations (InMemory, MariaDB and SQLite).
* Added UpdateGunGameWins to IPlayerRepository.
* Updated SQL scripts and seed data.
* Increment and update GunGame wins after a player completes the weapon progression.
* Display GunGame wins in the /mystats command.
* Added unit and integration tests.

Author: DevD4v3

src/Application/GunGames/Results/PlayerLeveledDown.cs

@@ -24,6 +24,7 @@ public void Handle(KillContext context)
             Level  = victimProgression.WeaponLevel,
             Weapon = newWeapon.Name
         });
+
         worldService.SendClientMessage(Color.Yellow, message);
     }
 }

src/Application/GunGames/Results/PlayerLeveledUp.cs

@@ -22,6 +22,7 @@ public void Handle(KillContext context)
             Level  = killerProgression.WeaponLevel,
             Weapon = newWeapon.Name
         });
+
         worldService.SendClientMessage(Color.Yellow, message);
     }
 }

src/Application/GunGames/Results/PlayerReachedFinalLevel.cs

@@ -20,6 +20,7 @@ public void Handle(KillContext context)
             Killer = context.Killer.Name,
             Weapon = newWeapon.Name
         });
+
         worldService.SendClientMessage(Color.Yellow, message);
     }
 }

src/Application/GunGames/Results/PlayerScoredFinalKill.cs

@@ -4,16 +4,22 @@
 /// Handles the <see cref="GunGameResult.ScoredFinalKill"/> result.
 /// </summary>
 public class PlayerScoredFinalKill(
-    IWorldService worldService) : IGunGameResultHandler
+    IWorldService worldService,
+    IPlayerRepository playerRepository) : IGunGameResultHandler
 {
     public GunGameResult Result => GunGameResult.ScoredFinalKill;
 
     public void Handle(KillContext context)
     {
+        PlayerInfo killerInfo = context.Killer.GetRequiredInfo();
+        killerInfo.AddGunGameWins();
+        playerRepository.UpdateGunGameWins(killerInfo);
+
         var message = Smart.Format(GunGameMessages.PlayerScoredFinalKill, new
         {
             Killer = context.Killer.Name
         });
+
         worldService.SendClientMessage(Color.Gold, message);
     }
 }

src/Application/Players/Accounts/IPlayerRepository.cs

@@ -15,6 +15,7 @@ public interface IPlayerRepository
     void UpdateDroppedFlags(PlayerInfo player);
     void UpdateReturnedFlags(PlayerInfo player);
     void UpdateHeadShots(PlayerInfo player);
+    void UpdateGunGameWins(PlayerInfo player);
     void UpdateRole(PlayerInfo player);
     void UpdateSkin(PlayerInfo player);
     void UpdateRank(PlayerInfo player);

src/Application/Players/Accounts/PlayerInfo.cs

@@ -52,6 +52,12 @@ public PlayerInfo() { }
     /// Indicates the number of shots that the player has made at the heads of other players.
     /// </summary>
     public int HeadShots { get; private set; }
+
+    /// <summary>
+    /// Indicates the number of times the player has won a GunGame match.
+    /// </summary>
+    public int GunGameWins { get; private set; }
+
     public RoleId RoleId { get; private set; } = RoleId.Basic;
     public int SkinId { get; private set; } = NoSkin;
     public RankId RankId { get; private set; } = RankId.Noob;
@@ -80,6 +86,7 @@ public PlayerInfo() { }
     public void AddDroppedFlags() => DroppedFlags++;
     public void AddReturnedFlags() => ReturnedFlags++;
     public void AddHeadShots() => HeadShots++;
+    public void AddGunGameWins() => GunGameWins++;
 
     public Result SetName(string value)
     {

src/Application/Players/Accounts/Statistics/PlayerStatsSystem.cs

@@ -116,6 +116,7 @@ private static string GetPlayerContent(Player player)
         Dropped Flags: {playerInfo.DroppedFlags}
         Returned Flags: {playerInfo.ReturnedFlags}
         HeadShots: {playerInfo.HeadShots}
+        GunGame Wins: {playerInfo.GunGameWins}
         Role: {playerInfo.RoleId}
         Rank: {playerInfo.RankId}
         Registration Date: {createdAt}

src/Persistence/Persistence.InMemory/FakePlayer.cs

@@ -22,6 +22,7 @@ public FakePlayer(string name, string passwordHash)
     public int DroppedFlags { get; set; }
     public int ReturnedFlags { get; set; }
     public int HeadShots { get; set; }
+    public int GunGameWins { get; set; }
     public int SkinId { get; set; } = NoSkin;
     public RoleId RoleId { get; set; } = RoleId.Basic;
     public RankId RankId { get; set; } = RankId.Noob;

src/Persistence/Persistence.InMemory/FakePlayerRepository.cs

@@ -7,7 +7,23 @@ internal class FakePlayerRepository(
     public void Create(PlayerInfo player)
     {
         var passwordHash = passwordHasher.HashPassword(player.Password);
-        var fakePlayer = new FakePlayer(player.Name, passwordHash);
+        var fakePlayer = new FakePlayer(player.Name, passwordHash)
+        {
+            TotalKills       = player.TotalKills,
+            TotalDeaths      = player.TotalDeaths,
+            MaxKillingSpree  = player.MaxKillingSpree,
+            BroughtFlags     = player.BroughtFlags,
+            CapturedFlags    = player.CapturedFlags,
+            DroppedFlags     = player.DroppedFlags,
+            ReturnedFlags    = player.ReturnedFlags,
+            HeadShots        = player.HeadShots,
+            GunGameWins      = player.GunGameWins,
+            SkinId           = player.SkinId,
+            RoleId           = player.RoleId,
+            RankId           = player.RankId,
+            CreatedAt        = player.CreatedAt,
+            LastConnection   = player.LastConnection
+        };
         players.Add(fakePlayer.Id, fakePlayer);
         // The Account ID is immutable and lacks a public setter; Reflection is used to modify it.
         player.SetValue(value: fakePlayer.Id, propertyName: nameof(PlayerInfo.AccountId));
@@ -47,6 +63,7 @@ public PlayerInfo GetOrDefault(string name)
         playerInfo.SetValue(value: fakePlayer.DroppedFlags,   propertyName: nameof(PlayerInfo.DroppedFlags));
         playerInfo.SetValue(value: fakePlayer.ReturnedFlags,  propertyName: nameof(PlayerInfo.ReturnedFlags));
         playerInfo.SetValue(value: fakePlayer.HeadShots,      propertyName: nameof(PlayerInfo.HeadShots));
+        playerInfo.SetValue(value: fakePlayer.GunGameWins,    propertyName: nameof(PlayerInfo.GunGameWins));
         playerInfo.SetValue(value: fakePlayer.CreatedAt,      propertyName: nameof(PlayerInfo.CreatedAt));
         playerInfo.SetValue(value: fakePlayer.LastConnection, propertyName: nameof(PlayerInfo.LastConnection));
         return playerInfo;
@@ -67,6 +84,9 @@ public void UpdateReturnedFlags(PlayerInfo player)
     public void UpdateHeadShots(PlayerInfo player)
         => players[player.AccountId].HeadShots = player.HeadShots;
 
+    public void UpdateGunGameWins(PlayerInfo player)
+        => players[player.AccountId].GunGameWins = player.GunGameWins;
+
     public void UpdateLastConnection(PlayerInfo player)
         => players[player.AccountId].LastConnection = player.LastConnection;
 

src/Persistence/Persistence.MariaDB/PlayerRepository.cs

@@ -23,6 +23,7 @@ public void Create(PlayerInfo player)
         command.Parameters.AddWithValue("@dropped_flags",     player.DroppedFlags);
         command.Parameters.AddWithValue("@returned_flags",    player.ReturnedFlags);
         command.Parameters.AddWithValue("@head_shots",        player.HeadShots);
+        command.Parameters.AddWithValue("@gungame_wins",      player.GunGameWins);
         command.Parameters.AddWithValue("@role_id",           player.RoleId.ToString());
         command.Parameters.AddWithValue("@skin_id",           player.SkinId);
         command.Parameters.AddWithValue("@rank_id",           player.RankId);
@@ -81,6 +82,7 @@ public PlayerInfo GetOrDefault(string name)
         playerInfo.SetValue(value: reader.GetInt32("dropped_flags"),      propertyName: nameof(PlayerInfo.DroppedFlags));
         playerInfo.SetValue(value: reader.GetInt32("returned_flags"),     propertyName: nameof(PlayerInfo.ReturnedFlags));
         playerInfo.SetValue(value: reader.GetInt32("head_shots"),         propertyName: nameof(PlayerInfo.HeadShots));
+        playerInfo.SetValue(value: reader.GetInt32("gungame_wins"),       propertyName: nameof(PlayerInfo.GunGameWins));
         playerInfo.SetValue(value: reader.GetDateTime("created_at"),      propertyName: nameof(PlayerInfo.CreatedAt));
         playerInfo.SetValue(value: reader.GetDateTime("last_connection"), propertyName: nameof(PlayerInfo.LastConnection));
         return playerInfo;
@@ -101,6 +103,9 @@ public void UpdateReturnedFlags(PlayerInfo player)
     public void UpdateHeadShots(PlayerInfo player)
         => Update(player.AccountId, "head_shots", player.HeadShots);
 
+    public void UpdateGunGameWins(PlayerInfo player)
+        => Update(player.AccountId, "gungame_wins", player.GunGameWins);
+
     public void UpdateLastConnection(PlayerInfo player)
         => Update(player.AccountId, "last_connection", player.LastConnection);