feat(API/PlayerManager): Helpers (suggestion from @zakriamansoor47)

Author: skuzzis

ACKNOWLEDGEMENTS.md

@@ -25,6 +25,24 @@ CS2Fixes is and will always be a great repository for RE stuff in CS2.
  */
 ```
 
+## CS2KZ-Metamod
+
+We've taken CMoveData structure and it's stuff used in that.
+
+```
+/*
+ *  CS2KZ-Metamod is free software: you can redistribute it and/or modify
+ *  it under the terms of the GNU General Public License as published by
+ *  the Free Software Foundation, either version 3 of the License, or
+ *  (at your option) any later version.
+ *
+ *  CS2KZ-Metamod is distributed in the hope that it will be useful,
+ *  but WITHOUT ANY WARRANTY; without even the implied warranty of
+ *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
+ *  GNU General Public License for more details.
+ */
+```
+
 ## CounterStrikeSharp
 
 We've inspired the feature VoiceManager with the one from CounterStrikeSharp.

managed/src/SwiftlyS2.Core/Modules/Players/PlayerManagerService.cs

@@ -164,6 +164,39 @@ public IEnumerable<IPlayer> FindTargettedPlayers( IPlayer player, string target,
         return allPlayers;
     }
 
+    public IEnumerable<IPlayer> GetBots()
+    {
+        return GetAllPlayers().Where(p => p.IsFakeClient);
+    }
+    public IEnumerable<IPlayer> GetAlive()
+    {
+        return GetAllPlayers().Where(p => p.Pawn?.LifeState == (byte)LifeState_t.LIFE_ALIVE);
+    }
+    public IEnumerable<IPlayer> GetCT()
+    {
+        return GetAllPlayers().Where(p => p.Pawn?.TeamNum == (int)Team.CT);
+    }
+    public IEnumerable<IPlayer> GetT()
+    {
+        return GetAllPlayers().Where(p => p.Pawn?.TeamNum == (int)Team.T);
+    }
+    public IEnumerable<IPlayer> GetSpectators()
+    {
+        return GetAllPlayers().Where(p => p.Pawn?.TeamNum == (int)Team.Spectator);
+    }
+    public IEnumerable<IPlayer> GetInTeam( Team team )
+    {
+        return GetAllPlayers().Where(p => p.Pawn?.TeamNum == (int)team);
+    }
+    public IEnumerable<IPlayer> GetTAlive()
+    {
+        return GetAllPlayers().Where(p => p.Pawn?.TeamNum == (int)Team.T && p.Pawn?.LifeState == (byte)LifeState_t.LIFE_ALIVE);
+    }
+    public IEnumerable<IPlayer> GetCTAlive()
+    {
+        return GetAllPlayers().Where(p => p.Pawn?.TeamNum == (int)Team.CT && p.Pawn?.LifeState == (byte)LifeState_t.LIFE_ALIVE);
+    }
+
     public void SendMessage( MessageType kind, string message, int htmlDuration = 5000 )
     {
         NativePlayerManager.SendMessage((int)kind, message, htmlDuration);

managed/src/SwiftlyS2.Shared/Modules/Players/IPlayerManager.cs

@@ -92,6 +92,48 @@ public interface IPlayerManagerService
     /// <returns>An enumerable collection of <see cref="IPlayer"/> instances representing all online players.</returns>
     public IEnumerable<IPlayer> GetAllPlayers();
 
+    /// <summary>
+    /// Retrieves all bot players currently online.
+    /// </summary>
+    /// <returns>An enumerable collection of <see cref="IPlayer"/> instances representing all online bot players.</returns>
+    public IEnumerable<IPlayer> GetBots();
+    /// <summary>
+    /// Retrieves all alive players currently online.
+    /// </summary>
+    /// <returns>An enumerable collection of <see cref="IPlayer"/> instances representing all alive players currently online.</returns>
+    public IEnumerable<IPlayer> GetAlive();
+    /// <summary>
+    /// Retrieves all CT players currently online.
+    /// </summary>
+    /// <returns>An enumerable collection of <see cref="IPlayer"/> instances representing all CT players currently online.</returns>
+    public IEnumerable<IPlayer> GetCT();
+    /// <summary>
+    /// Retrieves all T players currently online.
+    /// </summary>
+    /// <returns>An enumerable collection of <see cref="IPlayer"/> instances representing all T players currently online.</returns>
+    public IEnumerable<IPlayer> GetT();
+    /// <summary>
+    /// Retrieves all spectator players currently online.
+    /// </summary>
+    /// <returns>An enumerable collection of <see cref="IPlayer"/> instances representing all spectator players currently online.</returns>
+    public IEnumerable<IPlayer> GetSpectators();
+    /// <summary>
+    /// Retrieves all players in the specified team.
+    /// </summary>
+    /// <param name="team">The team for which to retrieve players.</param>
+    /// <returns>An enumerable collection of <see cref="IPlayer"/> instances representing all players in the specified team.</returns>
+    public IEnumerable<IPlayer> GetInTeam( Team team );
+    /// <summary>
+    /// Retrieves all alive T players currently online.
+    /// </summary>
+    /// <returns>An enumerable collection of <see cref="IPlayer"/> instances representing all alive T players currently online.</returns>
+    public IEnumerable<IPlayer> GetTAlive();
+    /// <summary>
+    /// Retrieves all alive CT players currently online.
+    /// </summary>
+    /// <returns>An enumerable collection of <see cref="IPlayer"/> instances representing all alive CT players currently online.</returns>
+    public IEnumerable<IPlayer> GetCTAlive();
+
     /// <summary>
     /// Finds targetted players based on the provided search criteria.
     /// </summary>