feat: new virtual functions with wrapper methods (#87)

configs/addons/counterstrikesharp/configs/admin_groups.json

@@ -0,0 +1,23 @@
+{
+  "#css/admin": {
+    "flags": [
+      "@css/reservation",
+      "@css/generic",
+      "@css/kick",
+      "@css/ban",
+      "@css/unban",
+      "@css/vip",
+      "@css/slay",
+      "@css/changemap",
+      "@css/cvar",
+      "@css/config",
+      "@css/chat",
+      "@css/vote",
+      "@css/password",
+      "@css/rcon",
+      "@css/cheats",
+      "@css/root"
+    ],
+    "immunity": 100
+  }
+}

configs/addons/counterstrikesharp/configs/admin_overrides.json

@@ -0,0 +1,9 @@
+{
+  "example_command": {
+    "flags": [
+      "@css/custom-permission"
+    ],
+    "check_type": "all",
+    "enabled": true
+  }
+}

configs/addons/counterstrikesharp/configs/admins.json

@@ -1,24 +1,18 @@
 {
   "Erikj": {
     "identity": "76561197960265731",
+    "immunity": 100,
     "flags": [
-      "@css/reservation",
-      "@css/generic",
-      "@css/kick",
-      "@css/ban",
-      "@css/unban",
-      "@css/vip",
-      "@css/slay",
-      "@css/changemap",
-      "@css/cvar",
-      "@css/config",
-      "@css/chat",
-      "@css/vote",
-      "@css/password",
-      "@css/rcon",
-      "@css/cheats",
-      "@css/root"
-    ]
+      "@css/custom-flag-1",
+      "@css/custom-flag-2"
+    ],
+    "groups": [
+      "#css/admin"
+    ],
+    "command_overrides": {
+      "css_plugins": true,
+      "css": false
+    }
   },
   "Another erikj": {
     "identity": "STEAM_0:1:1",

configs/addons/counterstrikesharp/gamedata/gamedata.json

@@ -50,8 +50,54 @@
   "CBaseModelEntity_SetModel": {
     "signatures": {
         "library": "server",
-        "windows": "\\x48\\x89\\x5C\\x24\\x10\\x48\\x89\\x7C\\x24\\x20\\x55\\x48\\x8B\\xEC\\x48\\x83\\xEC\\x50\\x48\\x8B\\xF9\\x4C\\x8B\\xC2\\x48\\x8B\\x0D\\x69\\x07\\xD9\\x00",
-        "linux": "\\x55\\x48\\x89\\xF2\\x48\\x89\\xE5\\x41\\x54\\x49\\x89\\xFC\\x48\\x8D\\x7D\\xE0\\x48\\x83\\xEC\\x18\\x48\\x8D\\x05\\x15\\xD4\\xBF\\x00"
+        "windows": "\\x48\\x89\\x5C\\x24\\x10\\x48\\x89\\x7C\\x24\\x20\\x55\\x48\\x8B\\xEC\\x48\\x83\\xEC\\x50",
+        "linux": "\\x55\\x48\\x89\\xF2\\x48\\x89\\xE5\\x41\\x54\\x49\\x89\\xFC\\x48\\x8D\\x7D\\xE0\\x48\\x83\\xEC\\x18\\x48\\x8D\\x05\\x25"
+    }
+  },
+  "CCSPlayer_ItemServices_DropActivePlayerWeapon": {
+    "offsets": {
+        "windows": 20,
+        "linux": 19
+    }
+  },
+  "CCSPlayer_ItemServices_RemoveWeapons": {
+      "offsets": {
+          "windows": 21,
+          "linux": 20
+      }
+  },
+  "CGameSceneNode_GetSkeletonInstance": {
+    "offsets": {
+        "windows": 8,
+        "linux": 8
+    }
+  },
+  "CCSGameRules_TerminateRound": {
+    "signatures": {
+        "library": "server",
+        "windows": "\\x48\\x8B\\xC4\\x4C\\x89\\x48\\x20\\x55\\x56",
+        "linux": "\\x55\\x48\\x89\\xE5\\x41\\x57\\x41\\x56\\x41\\x55\\x49\\x89\\xFD\\x41\\x54\\x53\\x48\\x81\\xEC\\xE8\\x01\\x00\\x00"
+      }
+  },
+  "UTIL_CreateEntityByName": {
+    "signatures": {
+        "library": "server",
+        "windows": "\\x48\\x83\\xEC\\x48\\xC6\\x44\\x24\\x30\\x00\\x4C\\x8B\\xC1",
+        "linux": "\\x48\\x8D\\x05\\x49\\xB5\\xBC\\x00\\x55\\x48\\x89\\xFA\\x41\\x89\\xF0\\x48"
+      }
+  },
+  "CBaseEntity_DispatchSpawn": {
+    "signatures": {
+        "library": "server",
+        "windows": "\\x48\\x89\\x5C\\x24\\x10\\x57\\x48\\x83\\xEC\\x30\\x48\\x8B\\xDA\\x48\\x8B\\xF9\\x48\\x85\\xC9",
+        "linux": "\\x48\\x85\\xFF\\x74\\x4B\\x55\\x48\\x89\\xE5\\x41\\x56\\x41\\x55\\x49\\x89\\xFD"
+      }
+  },
+  "LegacyGameEventListener": {
+    "signatures": {
+      "library": "server",
+      "windows": "\\x48\\x8B\\x15\\x2A\\x2A\\x2A\\x2A\\x48\\x85\\xD2\\x74\\x2A\\x85\\xC9\\x74",
+      "linux": "\\x48\\x8B\\x05\\x2A\\x2A\\x2A\\x2A\\x48\\x85\\xC0\\x74\\x2A\\x83\\xFF\\x3F\\x76\\x2A\\x31\\xC0"
     }
   },
   "CBasePlayerPawn_CommitSuicide": {

docs/astro.config.mjs

@@ -36,6 +36,10 @@ export default defineConfig({
           label: 'Features',
           autogenerate: { directory: 'features' },
         },
+        {
+          label: 'Admin Framework',
+          autogenerate: { directory: 'admin-framework' },
+        },
         {
           label: 'Reference',
           autogenerate: { directory: 'reference' },

docs/src/content/docs/admin-framework/admin-command-attributes.md

@@ -0,0 +1,47 @@
+---
+title: Admin Command Attributes
+description: A guide on using the Admin Command Attributes in plugins.
+---
+
+## Assigning permissions to a Command
+
+Assigning permissions to a Command is as easy as tagging the Command method (function callback) with either a `RequiresPermissions` or `RequiresPermissionsOr` attribute. The difference between the two attributes is that `RequiresPermissionsOr` needs only one permission to be present on the caller to be passed, while `RequiresPermissions` needs the caller to have all permissions listed. CounterStrikeSharp handles all of the permission checks behind the scenes for you.
+
+```csharp
+[RequiresPermissions("@css/slay", "@custom/permission")]
+public void OnMyCommand(CCSPlayerController? caller, CommandInfo info)
+{
+    ...
+}
+```
+
+```csharp
+[RequiresPermissionsOr("@css/ban", "@custom/permission-2")]
+public void OnMyOtherCommand(CCSPlayerController? caller, CommandInfo info)
+{
+    ...
+}
+```
+
+You can even stack the attributes on top of each other, and all of them will be checked.
+
+```csharp
+// Requires (@css/cvar AND @custom/permission-1) AND either (@custom/permission-1 OR @custom/permission-2).
+[RequiresPermissions("@css/cvar", "@custom/permission-1")]
+[RequiresPermissionsOr("@css/ban", "@custom/permission-2")]
+public void OnMyComplexCommand(CCSPlayerController? caller, CommandInfo info)
+{
+    ...
+}
+```
+
+You can also check for groups using the same attributes.
+
+```csharp
+[RequiresPermissions("#css/simple-admin")]
+public void OnMyGroupCommand(CCSPlayerController? caller, CommandInfo info)
+{
+    ...
+}
+```
+

docs/src/content/docs/admin-framework/defining-admins.md

@@ -1,6 +1,6 @@
 ---
-title: Admin Framework
-description: A guide on using the Admin Framework in plugins.
+title: Defining Admins
+description: A guide on how to define admins for CounterStrikeSharp.
 ---
 
 ## Admin Framework
@@ -9,7 +9,7 @@ CounterStrikeSharp has a basic framework which allows plugin developers to assig
 
 ## Adding Admins
 
-Adding an Admin is as simple as creating a new entry in the `configs/admins.json` file. The important things you need to declare are the SteamID identifier and the permissions they have. CounterStrikeSharp will do all the heavy-lifting to decipher your SteamID. If you're familar with SourceMod, permission definitions are slightly different as they're defined by an array of strings instead of a string of characters.
+Adding an Admin is as simple as creating a new entry in the `configs/admins.json` file. The important things you need to declare are the SteamID identifier and the permissions they have. CounterStrikeSharp will do all the heavy-lifting to decipher your SteamID. If you're familiar with SourceMod, permission definitions are slightly different as they're defined by an array of strings instead of a string of characters.
 
 ```json
 {
@@ -20,27 +20,17 @@ Adding an Admin is as simple as creating a new entry in the `configs/admins.json
 }
 ```
 
-You can also manually assign permissions to players in code with `AddPlayerPermissions` and `RemovePlayerPermissions`. These changes are not saved to `configs/admins.json`.
+You can also manually assign permissions to players in code with `AdminManager.AddPlayerPermissions` and `AdminManager.RemovePlayerPermissions`. These changes are not saved to `configs/admins.json`.
 
-## Assigning permissions to a Command
-
-Assigning permissions to a Command is as easy as tagging the Command method (function callback) with a `RequiresPermissions` attribute.
-
-```csharp
-[RequiresPermissions("@css/slay", "@custom/permission")]
-public void OnMyCommand(CCSPlayerController? caller, CommandInfo info)
-{
-    ...
-}
-```
-
-CounterStrikeSharp handles all of the permission checks behind the scenes for you.
+:::note
+All user permissions MUST start with an at-symbol @ character, otherwise CounterStrikeSharp will not recognize the permission.
+:::
 
 ### Standard Permissions
 
 Because the flag system is just a list of strings associated with a user, there is no real list of letter based flags like there was previously in something like SourceMod. This means as a plugin author you can declare your own flags, scoped with an `@` symbol, like `@roflmuffin/guns`, which might be the permission to allow spawning of guns in a given command.
 
-However there is a somewhat standardised list of flags that it is advised you use if you are adding functionality that aligns with their purpose, and these are based on the original SourceMod flags:
+However there is a somewhat standardized list of flags that it is advised you use if you are adding functionality that aligns with their purpose, and these are based on the original SourceMod flags:
 
 ```shell
 @css/reservation # Reserved slot access.
@@ -60,3 +50,7 @@ However there is a somewhat standardised list of flags that it is advised you us
 @css/cheats # Change sv_cheats or use cheating commands.
 @css/root # Magically enables all flags and ignores immunity values.
 ```
+
+:::note
+CounterStrikeSharp does not implement traditional admin command such as `!slay`, `!kick`, and `!ban`. It is up to individual plugins to implement these commands.
+:::

docs/src/content/docs/admin-framework/defining-command-overrides.md

@@ -0,0 +1,53 @@
+---
+title: Defining Command Overrides
+description: A guide on how to define command overrides for CounterStrikeSharp.
+---
+
+## Defining Admin and Group specific overrides
+
+Command permissions can be overriden so specific admins or groups can execute the command, regardless of any permissions they may or may not have. You can define command overrides by adding the `command_overrides` key to each admin in `configs/admins.json` or group in `configs/admin_groups.json`. Command overrides can either be set to `true`, meaning the admin/group can execute the command, or `false`, meaning the admin/group cannot execute the command at all.
+
+```json
+{
+  "ZoNiCaL": {
+    "identity": "76561198808392634",
+    "flags": ["@css/changemap", "@css/generic"],
+    "immunity": 100,
+    "command_overrides": {
+			"example_command": true
+		}
+  }
+}
+```
+
+```json
+"#css/simple-admin": {
+  "flags": [
+    "@css/generic",
+    "@css/reservation",
+    "@css/ban",
+    "@css/slay",
+  ],
+  "command_overrides": {
+    "example_command_2": false
+  }
+}
+```
+
+You can set a command override for a player in code using `AdminManager.SetPlayerCommandOverride`.
+
+## Replacing Command permissions
+
+Command permissions can be entirely replaced. These are defined in `configs/admin_overrides.json`. The important things you need to declare are what commands are being changed and what their new flags are. Command overrides can be set to be enabled or disabled, and you can toggle them in code with `AdminManager.SetCommandOverrideState`. You can also specify whether the command override requires the caller to have all of the new permissions (similar to a `RequiresPermissions` attribute check) or only one or more permissions (similar to a `RequirePermissionsOr` attribute check). You cannot stack permission checks. 
+
+```json
+"css": {
+  "flags": [
+    "@css/custom-permission"
+  ],
+  "check_type": "all",
+  "enabled": true
+}
+```
+
+You can check if a command has been overriden in code using `AdminManager.CommandIsOverriden`, and you can manipulate the command override permissions using `AdminManager.AddPermissionOverride` and `AdminManager.RemovePermissionOverride`.

docs/src/content/docs/admin-framework/defining-groups.md

@@ -0,0 +1,25 @@
+---
+title: Defining Admin Groups
+description: A guide on how to define admin groups for CounterStrikeSharp.
+---
+
+## Adding Groups
+
+Groups can be created to group a series of permissions together under one tag. They are defined in `configs/admin_groups.json`. The important things you need to declare is the name of the group and the permissions they have.
+
+```json
+"#css/simple-admin": {
+  "flags": [
+    "@css/generic",
+    "@css/reservation",
+    "@css/ban",
+    "@css/slay",
+  ]
+}
+```
+
+:::note
+All group names MUST start with a hashtag # character, otherwise CounterStrikeSharp will recognize the group.
+:::
+
+Admins can be assigned to multiple groups and they will inherit their flags. You can manually assign groups to players in code with `AdminManager.AddPlayerToGroup` and `AdminManager.RemovePlayerFromGroup`.

docs/src/content/docs/admin-framework/defining-immunity.md

@@ -0,0 +1,36 @@
+---
+title: Defining Admin Immunity
+description: A guide on how to define immunity for admins for CounterStrikeSharp.
+---
+
+## Player Immunity
+
+Admins can be assigned an immunity value, similar to SourceMod. If an admin or player with a lower immunity value targets another admin or player with a larger immunity value, then the command will fail. You can define an immunity value by adding the `immunity` key to each admin in `configs/admins.json`.
+
+```json
+{
+  "ZoNiCaL": {
+    "identity": "76561198808392634",
+    "flags": ["@css/changemap", "@css/generic"],
+    "immunity": 100
+  }
+}
+```
+
+You can even assign an immunity value to groups. If an admin has a lower immunity value, the group's value will be used instead.
+
+```json
+"#css/simple-admin": {
+  "flags": [
+    "@css/generic",
+    "@css/reservation",
+    "@css/ban",
+    "@css/slay",
+  ],
+  "immunity": 100
+}
+```
+
+:::note
+CounterStrikeSharp does not automatically handle immunity checking. It is up to individual plugins to handle immunity checks as they can implement different ways of targeting players. This can be done in code with `AdminManager.CanPlayerTarget`. You can also set a player's immunity in code with `AdminManager.SetPlayerImmunity`.
+:::

docs/src/content/docs/guides/hello-world-plugin.md

@@ -34,6 +34,13 @@ Use your IDE (Visual Studio/Rider) to add a reference to the `CounterStrikeSharp
 </Project>
 ```
 
+:::tip
+Instead of manually adding a reference to `CounterStrikeSharp.Api.dll`, you can install the NuGet package `CounterStrikeSharp.Api` using the following:
+```shell
+dotnet add package CounterStrikeSharp.API
+```
+:::
+
 ### Creating a Plugin File
 
 Rename the default class file that came with your new project (by default it should be `Class1.cs`) to something more accurate, like `HelloWorldPlugin.cs`. Inside this file, we will insert the stub hello world plugin. Be sure to change the name and namespace so it matches your project name.

managed/CounterStrikeSharp.API/Core/API.cs

@@ -552,6 +552,17 @@ namespace CounterStrikeSharp.API.Core
 			}
 		}
 
+        public static void FireEventToClient(IntPtr gameevent, int clientindex){
+			lock (ScriptContext.GlobalScriptContext.Lock) {
+			ScriptContext.GlobalScriptContext.Reset();
+			ScriptContext.GlobalScriptContext.Push(gameevent);
+			ScriptContext.GlobalScriptContext.Push(clientindex);
+			ScriptContext.GlobalScriptContext.SetIdentifier(0x40B7C06C);
+			ScriptContext.GlobalScriptContext.Invoke();
+			ScriptContext.GlobalScriptContext.CheckErrors();
+			}
+		}
+
         public static string GetEventName(IntPtr gameevent){
 			lock (ScriptContext.GlobalScriptContext.Lock) {
 			ScriptContext.GlobalScriptContext.Reset();

managed/CounterStrikeSharp.API/Core/BasePlugin.cs

@@ -162,6 +162,42 @@ namespace CounterStrikeSharp.API.Core
                 var command = new CommandInfo(ptr, caller);
 
                 var methodInfo = handler?.GetMethodInfo();
+
+                if (!AdminManager.CommandIsOverriden(name))
+                {
+                    // Do not execute command if we do not have the correct permissions.
+                    var permissions = methodInfo?.GetCustomAttributes<BaseRequiresPermissions>();
+                    if (permissions != null)
+                    {
+                        foreach (var attr in permissions)
+                        {
+                            attr.Command = name;
+                            if (!attr.CanExecuteCommand(caller))
+                            {
+                                command.ReplyToCommand("[CSS] You do not have the correct permissions to execute this command.");
+                                return;
+                            }
+                        }
+                    }
+                }
+                // If this command has it's permissions overriden, we will do an AND check for all permissions.
+                else
+                {
+                    // I don't know if this is the most sane implementation of this, can be edited in code review.
+                    var data = AdminManager.GetCommandOverrideData(name);
+                    if (data != null)
+                    {
+                        var attrType = (data.CheckType == "all") ? typeof(RequiresPermissions) : typeof(RequiresPermissionsOr);
+                        var attr = (BaseRequiresPermissions)Activator.CreateInstance(attrType, args: AdminManager.GetPermissionOverrides(name));
+                        attr.Command = name;
+                        if (!attr.CanExecuteCommand(caller))
+                        {
+                            command.ReplyToCommand("[CSS] You do not have the correct permissions to execute this command.");
+                            return;
+                        }
+                    }
+                }
+
                 // Do not execute if we shouldn't be calling this command.
                 var helperAttribute = methodInfo?.GetCustomAttribute<CommandHelperAttribute>();
                 if (helperAttribute != null) 
@@ -185,14 +221,6 @@ namespace CounterStrikeSharp.API.Core
                     }
                 }
 
-                // Do not execute command if we do not have the correct permissions.
-                var permissions = methodInfo?.GetCustomAttribute<RequiresPermissions>()?.RequiredPermissions;
-                if (permissions != null && !AdminManager.PlayerHasPermissions(caller, permissions))
-                {
-                    command.ReplyToCommand("[CSS] You do not have the correct permissions to execute this command.");
-                    return;
-                }
-
                 handler?.Invoke(caller, command);
             });
 

managed/CounterStrikeSharp.API/Core/GlobalContext.cs

@@ -65,8 +65,14 @@ namespace CounterStrikeSharp.API.Core
             Console.WriteLine("Loading GameData from \"gamedata/gamedata.json\"");
             GameData.Load(Path.Combine(rootDir.FullName, "gamedata", "gamedata.json"));
 
+            Console.WriteLine("Loading Admin Groups from \"configs/admin_groups.json\"");
+            AdminManager.LoadAdminGroups(Path.Combine(rootDir.FullName, "configs", "admin_groups.json"));
             Console.WriteLine("Loading Admins from \"configs/admins.json\"");
-            AdminManager.Load(Path.Combine(rootDir.FullName, "configs", "admins.json"));
+            AdminManager.LoadAdminData(Path.Combine(rootDir.FullName, "configs", "admins.json"));
+            Console.WriteLine("Loading Admin Command Overrides from \"configs/admin_overrides.json\"");
+            AdminManager.LoadCommandOverrides(Path.Combine(rootDir.FullName, "configs", "admin_overrides.json"));
+
+            AdminManager.MergeGroupPermsIntoAdmins();
 
             for (var i = 1; i <= 9; i++)
             {
@@ -188,7 +194,7 @@ namespace CounterStrikeSharp.API.Core
             return plugin;
         }
 
-        [RequiresPermissions("can_execute_css_commands")]
+        [RequiresPermissions("@css/generic")]
         [CommandHelper(whoCanExecute: CommandUsage.CLIENT_AND_SERVER)]
         private void OnCSSCommand(CCSPlayerController? caller, CommandInfo info)
         {
@@ -201,7 +207,7 @@ namespace CounterStrikeSharp.API.Core
             return;
         }
 
-        [RequiresPermissions("can_execute_css_commands")]
+        [RequiresPermissions("@css/generic")]
         [CommandHelper(minArgs: 1, 
         usage: "[option]\n" +
                 "  list - List all plugins currently loaded.\n" +

managed/CounterStrikeSharp.API/Core/Model/CBaseEntity.cs

@@ -12,6 +12,11 @@ public partial class CBaseEntity
             Handle, position.Handle, angles.Handle, velocity.Handle);
     }
 
+    public void DispatchSpawn()
+    {
+        VirtualFunctions.CBaseEntity_DispatchSpawn(Handle, IntPtr.Zero);
+    }
+
     /// <summary>
     /// Shorthand for accessing an entity's CBodyComponent?.SceneNode?.AbsOrigin;
     /// </summary>

managed/CounterStrikeSharp.API/Core/Model/CCSGameRules.cs

@@ -0,0 +1,31 @@
+/*
+ *  This file is part of CounterStrikeSharp.
+ *  CounterStrikeSharp 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.
+ *
+ *  CounterStrikeSharp 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.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with CounterStrikeSharp.  If not, see <https://www.gnu.org/licenses/>. *
+ */
+
+using CounterStrikeSharp.API.Modules.Entities.Constants;
+using CounterStrikeSharp.API.Modules.Memory;
+
+namespace CounterStrikeSharp.API.Core;
+
+public partial class CCSGameRules
+{
+    /// <summary>
+    /// Terminate the round with the given delay and reason.
+    /// </summary>
+    public void TerminateRound(float delay, RoundEndReason roundEndReason)
+    {
+        VirtualFunctions.TerminateRound(Handle, roundEndReason, delay);
+    }
+}

managed/CounterStrikeSharp.API/Core/Model/CCSPlayerController.cs

@@ -47,9 +47,37 @@ public partial class CCSPlayerController
             Duration = 5,
             Userid = this
         };
-        @event.FireEvent(false);
+        @event.FireEventToClient(this);
     }
 
+    /// <summary>
+    /// Drops the active player weapon on the ground.
+    /// </summary>
+    public void DropActiveWeapon()
+    {
+        if (!PlayerPawn.IsValid) return;
+        if (!PlayerPawn.Value.IsValid) return;
+        if (PlayerPawn.Value.ItemServices == null) return;
+        if (PlayerPawn.Value.WeaponServices == null) return;
+        if (!PlayerPawn.Value.WeaponServices.ActiveWeapon.IsValid) return;
+
+        CCSPlayer_ItemServices itemServices = new CCSPlayer_ItemServices(PlayerPawn.Value.ItemServices.Handle);
+        CCSPlayer_WeaponServices weponServices = new CCSPlayer_WeaponServices(PlayerPawn.Value.WeaponServices.Handle);
+        itemServices.DropActivePlayerWeapon(weponServices.ActiveWeapon.Value);
+    }
+
+    /// <summary>
+    /// Removes every weapon from the player.
+    /// </summary>
+    public void RemoveWeapons()
+    {
+        if (!PlayerPawn.IsValid) return;
+        if (!PlayerPawn.Value.IsValid) return;
+        if (PlayerPawn.Value.ItemServices == null) return;
+
+        CCSPlayer_ItemServices itemServices = new CCSPlayer_ItemServices(PlayerPawn.Value.ItemServices.Handle);
+        itemServices.RemoveWeapons();
+    }
 
     public bool IsBot => ((PlayerFlags)Flags).HasFlag(PlayerFlags.FL_FAKECLIENT);
 

managed/CounterStrikeSharp.API/Core/Model/CCSPlayer_ItemServices.cs

@@ -0,0 +1,38 @@
+/*
+ *  This file is part of CounterStrikeSharp.
+ *  CounterStrikeSharp 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.
+ *
+ *  CounterStrikeSharp 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.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with CounterStrikeSharp.  If not, see <https://www.gnu.org/licenses/>. *
+ */
+
+using CounterStrikeSharp.API.Modules.Memory;
+
+namespace CounterStrikeSharp.API.Core;
+
+public partial class CCSPlayer_ItemServices
+{
+    /// <summary>
+    /// Drops the active player weapon on the ground.
+    /// </summary>
+    public void DropActivePlayerWeapon(CBasePlayerWeapon activeWeapon)
+    {
+        VirtualFunction.CreateVoid<nint, nint>(Handle, GameData.GetOffset("CCSPlayer_ItemServices_DropActivePlayerWeapon"))(Handle, activeWeapon.Handle);
+    }
+    
+    /// <summary>
+    /// Removes every weapon from the player.
+    /// </summary>
+    public void RemoveWeapons()
+    {
+        VirtualFunction.CreateVoid<nint>(Handle, GameData.GetOffset("CCSPlayer_ItemServices_RemoveWeapons"))(Handle);
+    }
+}

managed/CounterStrikeSharp.API/Core/Model/CGameSceneNode.cs

@@ -0,0 +1,30 @@
+/*
+ *  This file is part of CounterStrikeSharp.
+ *  CounterStrikeSharp 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.
+ *
+ *  CounterStrikeSharp 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.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with CounterStrikeSharp.  If not, see <https://www.gnu.org/licenses/>. *
+ */
+
+using CounterStrikeSharp.API.Modules.Memory;
+
+namespace CounterStrikeSharp.API.Core;
+
+public partial class CGameSceneNode
+{
+    /// <summary>
+    /// Gets the <see cref="CSkeletonInstance"/> instance from the node.
+    /// </summary>
+    public CSkeletonInstance GetSkeletonInstance()
+    {
+        return new CSkeletonInstance(VirtualFunction.Create<nint, nint>(Handle, GameData.GetOffset("CGameSceneNode_GetSkeletonInstance"))(Handle));
+    }
+}

managed/CounterStrikeSharp.API/Modules/Admin/AdminCommandOverrides.cs

@@ -0,0 +1,176 @@
+using CounterStrikeSharp.API.Core;
+using CounterStrikeSharp.API.Modules.Entities;
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Text.Json.Serialization;
+using System.Text.Json;
+using System.Linq;
+
+namespace CounterStrikeSharp.API.Modules.Admin
+{
+
+    public partial class CommandData
+    {
+        [JsonPropertyName("flags")] public required HashSet<string> Flags { get; init; }
+        [JsonPropertyName("enabled")] public bool Enabled { get; set; } = true;
+        [JsonPropertyName("check_type")] public required string CheckType { get; init; }
+    }
+
+    public static partial class AdminManager
+    {
+        private static Dictionary<string, CommandData> CommandOverrides = new();
+        public static void LoadCommandOverrides(string overridePath)
+        {
+            try
+            {
+                if (!File.Exists(overridePath))
+                {
+                    Console.WriteLine("Admin command overrides file not found. Skipping admin command overrides load.");
+                    return;
+                }
+
+                var overridesFromFile = JsonSerializer.Deserialize<Dictionary<string, CommandData>>
+                    (File.ReadAllText(overridePath), new JsonSerializerOptions() { ReadCommentHandling = JsonCommentHandling.Skip });
+                if (overridesFromFile == null) { throw new FileNotFoundException(); }
+                foreach (var (command, overrideDef) in overridesFromFile)
+                {
+                    if (CommandOverrides.ContainsKey(command))
+                    {
+                        CommandOverrides[command].Flags.UnionWith(overrideDef.Flags);
+                    }
+                    else
+                    {
+                        CommandOverrides.Add(command, overrideDef);
+                    }
+                }
+
+                Console.WriteLine($"Loaded {CommandOverrides.Count} admin command overrides.");
+            }
+            catch (Exception ex)
+            {
+                Console.WriteLine($"Failed to load admin command overrides: {ex}");
+            }
+        }
+
+        /// <summary>
+        /// Checks to see if a command has overriden permissions.
+        /// </summary>
+        /// <param name="commandName">Name of the command.</param>
+        /// <returns>True if the command has overriden permissions, false if not.</returns>
+        public static bool CommandIsOverriden(string commandName)
+        {
+            CommandOverrides.TryGetValue(commandName, out var overrideDef);
+            if (overrideDef == null) return false;
+            return overrideDef.Enabled && overrideDef?.Flags.Count() > 0;
+        }
+
+        /// <summary>
+        /// Grabs the data for a command override that was loaded from "configs/admin_overrides.json".
+        /// </summary>
+        /// <param name="commandName">Name of the command.</param>
+        /// <returns>CommandData class if found, null if not.</returns>
+        public static CommandData? GetCommandOverrideData(string commandName)
+        {
+            return CommandOverrides.GetValueOrDefault(commandName);
+        }
+
+        /// <summary>
+        /// Grabs the new, overriden flags for a command.
+        /// </summary>
+        /// <param name="commandName">Name of the command.</param>
+        /// <returns>If the command is valid, a valid array of flags.</returns>
+        public static string[] GetPermissionOverrides(string commandName)
+        {
+            CommandOverrides.TryGetValue(commandName, out var overrideDef);
+            return overrideDef?.Flags.ToArray() ?? new string[] { };
+        }
+
+        /// <summary>
+        /// Adds a new permission to a command override. 
+        /// This is not saved to "configs/admin_overrides.json".
+        /// </summary>
+        /// <param name="commandName">Name of the command.</param>
+        /// <param name="permissions">Permissions to add to the command override.</param>
+        public static void AddPermissionOverride(string commandName, params string[] permissions)
+        {
+            CommandOverrides.TryGetValue(commandName, out var overrideDef);
+            if (overrideDef == null)
+            {
+                overrideDef = new CommandData()
+                {
+                    Flags = new(permissions),
+                    Enabled = true,
+                    CheckType = "all"
+                };
+
+                CommandOverrides[commandName] = overrideDef;
+                return;
+            }
+
+            foreach (var flag in permissions)
+            {
+                overrideDef.Flags.Add(flag);
+            }
+            CommandOverrides[commandName] = overrideDef;
+        }
+
+        /// <summary>
+        /// Removes a permission from a command override.
+        /// This is not saved to "configs/admin_overrides.json".
+        /// </summary>
+        /// <param name="commandName">Name of the command.</param>
+        /// <param name="permissions">Permissions to remove from the command override.</param>
+        public static void RemovePermissionOverride(string commandName, params string[] permissions)
+        {
+            CommandOverrides.TryGetValue(commandName, out var overrideDef);
+            if (overrideDef == null) return;
+
+            overrideDef.Flags.ExceptWith(permissions);
+            CommandOverrides[commandName] = overrideDef;
+        }
+
+        /// <summary>
+        /// Clears all permissions from a command override.
+        /// This is not saved to "configs/admin_overrides.json".
+        /// </summary>
+        /// <param name="commandName">Name of the command.</param>
+        /// <param name="disable">Whether to disable the command override after clearing.</param>
+        public static void ClearPermissionOverride(string commandName, bool disable = true)
+        {
+            CommandOverrides.TryGetValue(commandName, out var overrideDef);
+            if (overrideDef == null) return;
+
+            overrideDef.Flags?.Clear();
+            overrideDef.Enabled = !disable;
+            CommandOverrides[commandName] = overrideDef;
+        }
+
+        /// <summary>
+        /// Deletes a command override.
+        /// This is not saved to "configs/admin_overrides.json".
+        /// </summary>
+        /// <param name="commandName">Name of the command.</param>
+        public static void DeleteCommandOverride(string commandName)
+        {
+            if (!CommandOverrides.ContainsKey(commandName)) return;
+            CommandOverrides.Remove(commandName);
+        }
+
+        /// <summary>
+        /// Sets a command override to be enabled or disabled.
+        /// This is not saved to "configs/admin_overrides.json".
+        /// </summary>
+        /// <param name="commandName">Name of the command.</param>
+        /// <param name="state">New state of the command override.</param>
+        public static void SetCommandOverideState(string commandName, bool state)
+        {
+            CommandOverrides.TryGetValue(commandName, out var overrideDef);
+            if (overrideDef == null) return;
+
+            overrideDef.Flags?.Clear();
+            overrideDef.Enabled = state;
+            CommandOverrides[commandName] = overrideDef;
+        }
+    }
+}

managed/CounterStrikeSharp.API/Modules/Admin/AdminGroup.cs

@@ -0,0 +1,193 @@
+using System;
+using System.Collections.Generic;
+using System.IO;
+using System.Linq;
+using System.Text;
+using System.Text.Json;
+using System.Text.Json.Serialization;
+
+using CounterStrikeSharp.API.Core;
+using CounterStrikeSharp.API.Modules.Entities;
+
+namespace CounterStrikeSharp.API.Modules.Admin
+{
+    public partial class AdminData
+    {
+        [JsonPropertyName("groups")] public HashSet<string> Groups { get; init; } = new();
+    }
+    public partial class AdminGroupData
+    {
+        [JsonPropertyName("flags")] public required HashSet<string> Flags { get; init; }
+        [JsonPropertyName("immunity")] public uint Immunity { get; set; } = 0;
+        [JsonPropertyName("command_overrides")] public Dictionary<string, bool> CommandOverrides { get; init; } = new();
+    }
+
+    public static partial class AdminManager
+    {
+        private static Dictionary<string, AdminGroupData> Groups = new();
+
+        public static void LoadAdminGroups(string adminGroupsPath)
+        {
+            try
+            {
+                if (!File.Exists(adminGroupsPath))
+                {
+                    Console.WriteLine("Admin groups file not found. Skipping admin groups load.");
+                    return;
+                }
+
+                var groupsFromFile = JsonSerializer.Deserialize<Dictionary<string, AdminGroupData>>(File.ReadAllText(adminGroupsPath), new JsonSerializerOptions() { ReadCommentHandling = JsonCommentHandling.Skip });
+                if (groupsFromFile == null) { throw new FileNotFoundException(); }
+                foreach (var (key, groupDef) in groupsFromFile)
+                {
+                    if (Groups.ContainsKey(key))
+                    {
+                        Groups[key].Flags.UnionWith(groupDef.Flags);
+                        if (groupDef.Immunity > Groups[key].Immunity)
+                        {
+                            Groups[key].Immunity = groupDef.Immunity;
+                        }
+                    }
+                    else
+                    {
+                        Groups.Add(key, groupDef);
+                    }
+                }
+
+                Console.WriteLine($"Loaded {Groups.Count} admin groups.");
+            }
+            catch (Exception ex)
+            {
+                Console.WriteLine($"Failed to load admin groups: {ex}");
+            }
+
+            // Loop over each of the admins. If one of our admins is in a group,
+            // add the flags from the group to their admin definition and change
+            // the admin's immunity if it's higher.
+            foreach (var adminData in Admins.Values)
+            {
+                var groups = adminData.Groups;
+                foreach (var group in groups)
+                {
+                    // roflmuffin is probably smart enough to condense this function down ;)
+                    if (Groups.TryGetValue(group, out var groupData))
+                    {
+                        adminData.Flags.UnionWith(groupData.Flags);
+                        if (groupData.Immunity > adminData.Immunity)
+                        {
+                            adminData.Immunity = groupData.Immunity;
+                        }
+                    }
+                }
+            }
+        }
+
+        /// <summary>
+        /// Checks to see if the player is part of an admin group.
+        /// </summary>
+        /// <param name="player">Player controller.</param>
+        /// <param name="groups">Groups to check for.</param>
+        /// <returns>True if a player is part of all of the groups provided, false if not.</returns>
+        public static bool PlayerInGroup(CCSPlayerController? player, params string[] groups)
+        {
+            // This is here for cases where the server console is attempting to call commands.
+            // The server console should have access to all commands, regardless of groups.
+            if (player == null) return true;
+            if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) { return false; }
+            var playerData = GetPlayerAdminData((SteamID)player.SteamID);
+            return playerData?.Groups.IsSupersetOf(groups) ?? false;
+        }
+
+        /// <summary>
+        /// Checks to see if the player is part of an admin group.
+        /// </summary>
+        /// <param name="steamId">SteamID of the player.</param>
+        /// <param name="groups">Groups to check for.</param>
+        /// <returns>True if a player is part of all of the groups provided, false if not.</returns>
+        public static bool PlayerInGroup(SteamID steamId, params string[] groups)
+        {
+            var playerData = GetPlayerAdminData(steamId);
+            return playerData?.Groups.IsSupersetOf(groups) ?? false;
+        }
+
+        /// <summary>
+        /// Adds a player to a group.
+        /// </summary>
+        /// <param name="player">Player controller.</param>
+        /// <param name="groups">Groups to add the player to.</param>
+        public static void AddPlayerToGroup(CCSPlayerController? player, params string[] groups)
+        {
+            if (player == null) return;
+            if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) { return; }
+            AddPlayerToGroup((SteamID)player.SteamID, groups);
+        }
+
+        /// <summary>
+        /// Adds a player to a group.
+        /// </summary>
+        /// <param name="steamId">SteamID of the player.</param>
+        /// <param name="groups">Groups to add the player to.</param>
+        public static void AddPlayerToGroup(SteamID steamId, params string[] groups)
+        {
+            var data = GetPlayerAdminData(steamId);
+            if (data == null)
+            {
+                data = new AdminData()
+                {
+                    Identity = steamId.SteamId64.ToString(),
+                    Flags = new(),
+                    Groups = new(groups)
+                };
+            }
+
+            foreach (var group in groups)
+            {
+                if (Groups.TryGetValue(group, out var groupDef))
+                {
+                    data.Flags.UnionWith(groupDef.Flags);
+                    groupDef.CommandOverrides.ToList().ForEach(x => data.CommandOverrides[x.Key] = x.Value);
+                }
+            }
+            Admins[steamId] = data;
+        }
+
+        /// <summary>
+        /// Removes a player from a group.
+        /// </summary>
+        /// <param name="player">Player controller.</param>
+        /// <param name="removeInheritedFlags">If true, all of the flags that the player inherited from being in the group will be removed.</param>
+        /// <param name="groups"></param>
+        public static void RemovePlayerFromGroup(CCSPlayerController? player, bool removeInheritedFlags = true, params string[] groups)
+        {
+            if (player == null) return;
+            if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) { return; }
+            RemovePlayerFromGroup((SteamID)player.SteamID, true, groups);
+        }
+
+        /// <summary>
+        /// Removes a player from a group.
+        /// </summary>
+        /// <param name="steamId">SteamID of the player.</param>
+        /// <param name="removeInheritedFlags">If true, all of the flags that the player inherited from being in the group will be removed.</param>
+        /// <param name="groups"></param>
+        public static void RemovePlayerFromGroup(SteamID steamId, bool removeInheritedFlags = true, params string[] groups)
+        {
+            var data = GetPlayerAdminData(steamId);
+            if (data == null) return;
+
+            data.Groups.ExceptWith(groups);
+
+            if (removeInheritedFlags)
+            {
+                foreach (var group in groups)
+                {
+                    if (Groups.TryGetValue(group, out var groupDef))
+                    {
+                        data.Flags.ExceptWith(groupDef.Flags);
+                    }
+                }
+            }
+            Admins[steamId] = data;
+        }
+    }
+}

managed/CounterStrikeSharp.API/Modules/Admin/AdminManager.cs

@@ -1,44 +1,43 @@
-using System;
-using System.IO;
-using System.Collections.Generic;
-using System.Diagnostics;
-using System.Linq;
-using System.Text.Json.Serialization;
-using System.Text.Json;
-using CounterStrikeSharp.API.Core;
-using CounterStrikeSharp.API.Modules.Utils;
-using CounterStrikeSharp.API.Modules.Entities;
+using CounterStrikeSharp.API.Core;
 using CounterStrikeSharp.API.Modules.Commands;
+using CounterStrikeSharp.API.Modules.Utils;
+using System.IO;
+using System.Linq;
 using System.Reflection;
 
 namespace CounterStrikeSharp.API.Modules.Admin
 {
-    public partial class AdminData
-    {
-        [JsonPropertyName("identity")] public required string Identity { get; init; }
-        [JsonPropertyName("flags")] public required HashSet<string> Flags { get; init; }
-    }
 
-    public static class AdminManager
+    public static partial class AdminManager
     {
-        private static readonly Dictionary<SteamID, AdminData> Admins = new();
-
         static AdminManager()
         {
             CommandUtils.AddStandaloneCommand("css_admins_reload", "Reloads the admin file.", ReloadAdminsCommand);
             CommandUtils.AddStandaloneCommand("css_admins_list", "List admins and their flags.", ListAdminsCommand);
+            CommandUtils.AddStandaloneCommand("css_groups_reload", "Reloads the admin groups file.", ReloadAdminGroupsCommand);
+            CommandUtils.AddStandaloneCommand("css_groups_list", "List admin groups and their flags.", ListAdminGroupsCommand);
+            CommandUtils.AddStandaloneCommand("css_overrides_reload", "Reloads the admin command overrides file.", ReloadAdminOverridesCommand);
+            CommandUtils.AddStandaloneCommand("css_overrides_list", "List admin command overrides and their flags.", ListAdminOverridesCommand);
         }
 
-        [RequiresPermissions("can_reload_admins")]
+        public static void MergeGroupPermsIntoAdmins()
+        {
+            foreach (var (steamID, adminDef) in Admins)
+            {
+                AddPlayerToGroup(steamID, adminDef.Groups.ToArray());
+            }
+        }
+
+        [RequiresPermissions(permissions:"@css/generic")]
         [CommandHelper(whoCanExecute: CommandUsage.CLIENT_AND_SERVER)]
         private static void ReloadAdminsCommand(CCSPlayerController? player, CommandInfo command)
         {
             Admins.Clear();
             var rootDir = new FileInfo(Assembly.GetExecutingAssembly().Location).Directory.Parent;
-            Load(Path.Combine(rootDir.FullName, "configs", "admins.json"));
+            LoadAdminData(Path.Combine(rootDir.FullName, "configs", "admins.json"));
         }
-        
-        [RequiresPermissions("can_reload_admins")]
+
+        [RequiresPermissions(permissions:"@css/generic")]
         [CommandHelper(whoCanExecute: CommandUsage.CLIENT_AND_SERVER)]
         private static void ListAdminsCommand(CCSPlayerController? player, CommandInfo command)
         {
@@ -48,166 +47,42 @@ namespace CounterStrikeSharp.API.Modules.Admin
             }
         }
 
-        public static void Load(string adminDataPath)
+        [RequiresPermissions(permissions:"@css/generic")]
+        [CommandHelper(whoCanExecute: CommandUsage.CLIENT_AND_SERVER)]
+        private static void ReloadAdminGroupsCommand(CCSPlayerController? player, CommandInfo command)
         {
-            try
-            {
-                if (!File.Exists(adminDataPath))
-                {
-                    Console.WriteLine("Admin data file not found. Skipping admin data load.");
-                    return;
-                }
-                
-                var adminsFromFile = JsonSerializer.Deserialize<Dictionary<string, AdminData>>(File.ReadAllText(adminDataPath), new JsonSerializerOptions() { ReadCommentHandling = JsonCommentHandling.Skip });
-                if (adminsFromFile == null) { throw new FileNotFoundException(); }
-                foreach (var adminDef in adminsFromFile.Values)
-                {
-                    if (SteamID.TryParse(adminDef.Identity, out var steamId))
-                    {
-                        if (Admins.ContainsKey(steamId!))
-                        {
-                            Admins[steamId!].Flags.UnionWith(adminDef.Flags);
-                        }
-                        else
-                        {
-                            Admins.Add(steamId!, adminDef);
-                        }
-                    }
-                }
+            Groups.Clear();
+            var rootDir = new FileInfo(Assembly.GetExecutingAssembly().Location).Directory.Parent;
+            LoadAdminGroups(Path.Combine(rootDir.FullName, "configs", "admin_groups.json"));
+        }
 
-                Console.WriteLine($"Loaded admin data with {Admins.Count} admins.");
-            }
-            catch (Exception ex)
+        [RequiresPermissions(permissions: "@css/generic")]
+        [CommandHelper(whoCanExecute: CommandUsage.CLIENT_AND_SERVER)]
+        private static void ListAdminGroupsCommand(CCSPlayerController? player, CommandInfo command)
+        {
+            foreach (var (groupName, groupDef) in Groups)
             {
-                Console.WriteLine($"Failed to load admin data: {ex}");
+                command.ReplyToCommand($"{groupName} - {string.Join(", ", groupDef.Flags)}");
             }
         }
 
-        /// <summary>
-        /// Grabs the admin data for a player that was loaded from "configs/admins.json".
-        /// </summary>
-        /// <param name="steamId">SteamID object of the player.</param>
-        /// <returns>AdminData class if data found, null if not.</returns>
-        public static AdminData? GetPlayerAdminData(SteamID steamId)
+        [RequiresPermissions(permissions: "@css/generic")]
+        [CommandHelper(whoCanExecute: CommandUsage.CLIENT_AND_SERVER)]
+        private static void ReloadAdminOverridesCommand(CCSPlayerController? player, CommandInfo command)
         {
-            return Admins.GetValueOrDefault(steamId);
+            CommandOverrides.Clear();
+            var rootDir = new FileInfo(Assembly.GetExecutingAssembly().Location).Directory.Parent;
+            LoadCommandOverrides(Path.Combine(rootDir.FullName, "configs", "admin_overrides.json"));
         }
 
-        /// <summary>
-        /// Checks to see if a player has access to a certain set of permission flags.
-        /// </summary>
-        /// <param name="player">Player or server console.</param>
-        /// <param name="flags">Flags to look for in the players permission flags.</param>
-        /// <returns>True if flags are present, false if not.</returns>
-        public static bool PlayerHasPermissions(CCSPlayerController? player, params string[] flags)
+        [RequiresPermissions(permissions: "@css/generic")]
+        [CommandHelper(whoCanExecute: CommandUsage.CLIENT_AND_SERVER)]
+        private static void ListAdminOverridesCommand(CCSPlayerController? player, CommandInfo command)
         {
-            // This is here for cases where the server console is attempting to call commands.
-            // The server console should have access to all commands, regardless of permissions.
-            if (player == null) return true;
-            if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) { return false; }
-            var playerData = GetPlayerAdminData((SteamID)player.SteamID);
-            return playerData?.Flags.IsSupersetOf(flags) ?? false;
-        }
-
-        /// <summary>
-        /// Checks to see if a player has access to a certain set of permission flags.
-        /// </summary>
-        /// <param name="steamId">Steam ID object.</param>
-        /// <param name="flags">Flags to look for in the players permission flags.</param>
-        /// <returns>True if flags are present, false if not.</returns>
-        public static bool PlayerHasPermissions(SteamID steamId, params string[] flags)
-        {
-            var playerData = GetPlayerAdminData(steamId);
-            return playerData?.Flags.IsSupersetOf(flags) ?? false;
-        }
-        
-        /// <summary>
-        /// Temporarily adds a permission flag to the player. These flags are not saved to
-        /// "configs/admins.json".
-        /// </summary>
-        /// <param name="player">Player controller to add a flag to.</param>
-        /// <param name="flags">Flags to add for the player.</param>
-        public static void AddPlayerPermissions(CCSPlayerController? player, params string[] flags)
-        {
-            if (player == null) return;
-            if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) return;
-            AddPlayerPermissions((SteamID)player.SteamID, flags);
-        }
-        
-        /// <summary>
-        /// Temporarily adds a permission flag to the player. These flags are not saved to
-        /// "configs/admins.json".
-        /// </summary>
-        /// <param name="steamId">SteamID to add a flag to.</param>
-        /// <param name="flags">Flags to add for the player.</param>
-        public static void AddPlayerPermissions(SteamID steamId, params string[] flags)
-        {
-            var data = GetPlayerAdminData(steamId);
-            if (data == null)
+            foreach (var (commandName, commandDef) in CommandOverrides)
             {
-                data = new AdminData()
-                {
-                    Identity = steamId.SteamId64.ToString(),
-                    Flags = new(flags)
-                };
-
-                Admins[steamId] = data;
-                return;
+                command.ReplyToCommand($"{commandName} (enabled: {commandDef.Enabled.ToString()}) - {string.Join(", ", commandDef.Flags)}");
             }
-            
-            foreach (var flag in flags)
-            {
-                data.Flags.Add(flag);
-            }
-        }
-        
-        /// <summary>
-        /// Temporarily removes a permission flag to the player. These flags are not saved to
-        /// "configs/admins.json".
-        /// </summary>
-        /// <param name="player">Player controller to remove flags from.</param>
-        /// <param name="flags">Flags to remove from the player.</param>
-        public static void RemovePlayerPermissions(CCSPlayerController? player, params string[] flags)
-        {
-            if (player == null) return;
-            if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) return;
-
-            RemovePlayerPermissions((SteamID)player.SteamID, flags);
-        }
-
-        /// <summary>
-        /// Temporarily removes a permission flag to the player. These flags are not saved to
-        /// "configs/admins.json".
-        /// </summary>
-        /// <param name="steamId">Steam ID to remove flags from.</param>
-        /// <param name="flags">Flags to remove from the player.</param>
-        public static void RemovePlayerPermissions(SteamID steamId, params string[] flags)
-        {
-            var data = GetPlayerAdminData(steamId);
-            if (data == null) return;
-            
-            data.Flags.ExceptWith(flags);
-        }
-
-        /// <summary>
-        /// Removes a players admin data. This is not saved to "configs/admins.json"
-        /// </summary>
-        /// <param name="player">Player controller to remove admin data from.</param>
-        public static void RemovePlayerAdminData(CCSPlayerController? player)
-        {
-            if (player == null) return;
-            if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) return;
-
-            RemovePlayerAdminData((SteamID)player.SteamID);
-        }
-
-        /// <summary>
-        /// Removes a players admin data. This is not saved to "configs/admins.json"
-        /// </summary>
-        /// <param name="steamId">Steam ID remove admin data from.</param>
-        public static void RemovePlayerAdminData(SteamID steamId)
-        {
-            Admins.Remove(steamId);
         }
     }
 }

managed/CounterStrikeSharp.API/Modules/Admin/AdminPermissions.cs

@@ -0,0 +1,391 @@
+using System;
+using System.IO;
+using System.Collections.Generic;
+using System.Text.Json.Serialization;
+using System.Text.Json;
+using CounterStrikeSharp.API.Core;
+using CounterStrikeSharp.API.Modules.Utils;
+using CounterStrikeSharp.API.Modules.Entities;
+using CounterStrikeSharp.API.Modules.Commands;
+using System.Reflection;
+using System.Numerics;
+using System.Linq;
+
+namespace CounterStrikeSharp.API.Modules.Admin
+{
+    public partial class AdminData
+    {
+        [JsonPropertyName("identity")] public required string Identity { get; init; }
+        [JsonPropertyName("flags")] public required HashSet<string> Flags { get; init; }
+        [JsonPropertyName("immunity")] public uint Immunity { get; set; } = 0;
+        [JsonPropertyName("command_overrides")] public Dictionary<string, bool> CommandOverrides { get; init; } = new();
+    }
+
+    public static partial class AdminManager
+    {
+        private static Dictionary<SteamID, AdminData> Admins = new();
+
+        public static void LoadAdminData(string adminDataPath)
+        {
+            try
+            {
+                if (!File.Exists(adminDataPath))
+                {
+                    Console.WriteLine("Admin data file not found. Skipping admin data load.");
+                    return;
+                }
+                
+                var adminsFromFile = JsonSerializer.Deserialize<Dictionary<string, AdminData>>(File.ReadAllText(adminDataPath), new JsonSerializerOptions() { ReadCommentHandling = JsonCommentHandling.Skip });
+                if (adminsFromFile == null) { throw new FileNotFoundException(); }
+                foreach (var adminDef in adminsFromFile.Values)
+                {
+                    if (SteamID.TryParse(adminDef.Identity, out var steamId))
+                    {
+                        if (Admins.ContainsKey(steamId!))
+                        {
+                            Admins[steamId!].Flags.UnionWith(adminDef.Flags);
+                            if (adminDef.Immunity > Admins[steamId!].Immunity)
+                            {
+                                Admins[steamId!].Immunity = adminDef.Immunity;
+                            }
+                        }
+                        else
+                        {
+                            Admins.Add(steamId!, adminDef);
+                        }
+                    }
+                }
+
+                Console.WriteLine($"Loaded admin data with {Admins.Count} admins.");
+            }
+            catch (Exception ex)
+            {
+                Console.WriteLine($"Failed to load admin data: {ex}");
+            }
+        }
+
+        /// <summary>
+        /// Grabs the admin data for a player that was loaded from "configs/admins.json".
+        /// </summary>
+        /// <param name="steamId">SteamID object of the player.</param>
+        /// <returns>AdminData class if data found, null if not.</returns>
+        public static AdminData? GetPlayerAdminData(SteamID steamId)
+        {
+            return Admins.GetValueOrDefault(steamId);
+        }
+
+        /// <summary>
+        /// Removes a players admin data. This is not saved to "configs/admins.json"
+        /// </summary>
+        /// <param name="steamId">Steam ID remove admin data from.</param>
+        public static void RemovePlayerAdminData(SteamID steamId)
+        {
+            Admins.Remove(steamId);
+        }
+
+        #region Command Permission Checks
+
+        /// <summary>
+        /// Checks to see if a player has access to a certain set of permission flags.
+        /// </summary>
+        /// <param name="player">Player or server console.</param>
+        /// <param name="flags">Flags to look for in the players permission flags.</param>
+        /// <returns>True if flags are present, false if not.</returns>
+        public static bool PlayerHasPermissions(CCSPlayerController? player, params string[] flags)
+        {
+            // This is here for cases where the server console is attempting to call commands.
+            // The server console should have access to all commands, regardless of permissions.
+            if (player == null) return true;
+            if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) { return false; }
+            var playerData = GetPlayerAdminData((SteamID)player.SteamID);
+            return playerData?.Flags.IsSupersetOf(flags) ?? false;
+        }
+
+        /// <summary>
+        /// Checks to see if a player has access to a certain set of permission flags.
+        /// </summary>
+        /// <param name="steamId">Steam ID object.</param>
+        /// <param name="flags">Flags to look for in the players permission flags.</param>
+        /// <returns>True if flags are present, false if not.</returns>
+        public static bool PlayerHasPermissions(SteamID steamId, params string[] flags)
+        {
+            var playerData = GetPlayerAdminData(steamId);
+            return playerData?.Flags.IsSupersetOf(flags) ?? false;
+        }
+
+        #endregion
+
+        // This is placed here instead of in AdminCommandOverrides.cs as this all relates to admins that are
+        // defined within the "configs/admins.json" file.
+        #region Admin Specific Command Overrides
+        /// <summary>
+        /// Checks to see if a player has a command override. This does NOT return the actual
+        /// state of the override.
+        /// </summary>
+        /// <param name="player">Player or server console.</param>
+        /// <param name="command">Name of the command to check for.</param>
+        /// <returns>True if override exists, false if not.</returns>
+        public static bool PlayerHasCommandOverride(CCSPlayerController? player, string command)
+        {
+            // This is here for cases where the server console is attempting to call commands.
+            // The server console should have access to all commands, regardless of permissions.
+            if (player == null) return true;
+            if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) { return false; }
+            var playerData = GetPlayerAdminData((SteamID)player.SteamID);
+            return playerData?.CommandOverrides.ContainsKey(command) ?? false;
+        }
+
+        /// <summary>
+        /// Checks to see if a player has a command override. This does NOT return the actual
+        /// state of the override.
+        /// </summary>
+        /// <param name="steamId">Steam ID object.</param>
+        /// <param name="command">Name of the command to check for.</param>
+        /// <returns>True if override exists, false if not.</returns>
+        public static bool PlayerHasCommandOverride(SteamID steamId, string command)
+        {
+            var playerData = GetPlayerAdminData(steamId);
+            return playerData?.CommandOverrides.ContainsKey(command) ?? false;
+        }
+
+        /// <summary>
+        /// Gets the value of a command override state.
+        /// </summary>
+        /// <param name="player">Player or server console.</param>
+        /// <param name="command">Name of the command to check for.</param>
+        /// <returns>True if override is active, false if not.</returns>
+        public static bool GetPlayerCommandOverrideState(CCSPlayerController? player, string command)
+        {
+            // This is here for cases where the server console is attempting to call commands.
+            // The server console should have access to all commands, regardless of permissions.
+            if (player == null) return true;
+            if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) { return false; }
+            var playerData = GetPlayerAdminData((SteamID)player.SteamID);
+            return playerData?.CommandOverrides.GetValueOrDefault(command) ?? false;
+        }
+
+        /// <summary>
+        /// Gets the value of a command override state.
+        /// </summary>
+        /// <param name="steamId">Steam ID object.</param>
+        /// <param name="command">Name of the command to check for.</param>
+        /// <returns>True if override is active, false if not.</returns>
+        public static bool GetPlayerCommandOverrideState(SteamID steamId, string command)
+        {
+            var playerData = GetPlayerAdminData(steamId);
+            return playerData?.CommandOverrides.GetValueOrDefault(command) ?? false;
+        }
+
+        /// <summary>
+        /// Sets a player command override. This is not saved to "configs/admins.json".
+        /// </summary>
+        /// <param name="player">Player or server console.</param>
+        /// <param name="command">Name of the command to check for.</param>
+        /// <param name="state">New state of the command override.</param>
+        public static void SetPlayerCommandOverride(CCSPlayerController? player, string command, bool state)
+        {
+            // This is here for cases where the server console is attempting to call commands.
+            // The server console should have access to all commands, regardless of permissions.
+            if (player == null) return;
+            if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) { return; }
+            SetPlayerCommandOverride((SteamID)player.SteamID, command, state);
+        }
+
+        /// <summary>
+        /// Sets a player command override. This is not saved to "configs/admins.json".
+        /// </summary>
+        /// <param name="steamId">SteamID to add a flag to.</param>
+        /// <param name="command">Name of the command to check for.</param>
+        /// <param name="state">New state of the command override.</param>
+        public static void SetPlayerCommandOverride(SteamID steamId, string command, bool state)
+        {
+            var data = GetPlayerAdminData(steamId);
+            if (data == null)
+            {
+                data = new AdminData()
+                {
+                    Identity = steamId.SteamId64.ToString(),
+                    Flags = new(),
+                    Groups = new(),
+                    CommandOverrides = new() { { command, state } }
+                };
+
+                Admins[steamId] = data;
+                return;
+            }
+
+            data.CommandOverrides[command] = state;
+            Admins[steamId] = data;
+        }
+        #endregion
+
+        #region Manipulating Permissions
+        /// <summary>
+        /// Temporarily adds a permission flag to the player. These flags are not saved to
+        /// "configs/admins.json".
+        /// </summary>
+        /// <param name="player">Player controller to add a flag to.</param>
+        /// <param name="flags">Flags to add for the player.</param>
+        public static void AddPlayerPermissions(CCSPlayerController? player, params string[] flags)
+        {
+            if (player == null) return;
+            if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) return;
+            AddPlayerPermissions((SteamID)player.SteamID, flags);
+        }
+        
+        /// <summary>
+        /// Temporarily adds a permission flag to the player. These flags are not saved to
+        /// "configs/admins.json".
+        /// </summary>
+        /// <param name="steamId">SteamID to add a flag to.</param>
+        /// <param name="flags">Flags to add for the player.</param>
+        public static void AddPlayerPermissions(SteamID steamId, params string[] flags)
+        {
+            var data = GetPlayerAdminData(steamId);
+            if (data == null)
+            {
+                data = new AdminData()
+                {
+                    Identity = steamId.SteamId64.ToString(),
+                    Flags = new(flags),
+                    Groups = new()
+                };
+
+                Admins[steamId] = data;
+                return;
+            }
+            
+            foreach (var flag in flags)
+            {
+                data.Flags.Add(flag);
+            }
+            Admins[steamId] = data;
+        }
+        
+        /// <summary>
+        /// Temporarily removes a permission flag to the player. These flags are not saved to
+        /// "configs/admins.json".
+        /// </summary>
+        /// <param name="player">Player controller to remove flags from.</param>
+        /// <param name="flags">Flags to remove from the player.</param>
+        public static void RemovePlayerPermissions(CCSPlayerController? player, params string[] flags)
+        {
+            if (player == null) return;
+            if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) return;
+
+            RemovePlayerPermissions((SteamID)player.SteamID, flags);
+        }
+
+        /// <summary>
+        /// Temporarily removes a permission flag to the player. These flags are not saved to
+        /// "configs/admins.json".
+        /// </summary>
+        /// <param name="steamId">Steam ID to remove flags from.</param>
+        /// <param name="flags">Flags to remove from the player.</param>
+        public static void RemovePlayerPermissions(SteamID steamId, params string[] flags)
+        {
+            var data = GetPlayerAdminData(steamId);
+            if (data == null) return;
+            
+            data.Flags.ExceptWith(flags);
+            Admins[steamId] = data;
+        }
+
+        /// <summary>
+        /// Temporarily removes all permission flags from a player. These flags are not saved to
+        /// "configs/admins.json".
+        /// </summary>
+        /// <param name="player">Player controller to remove flags from.</param>
+        public static void ClearPlayerPermissions(CCSPlayerController? player)
+        {
+            if (player == null) return;
+            if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) return;
+
+            ClearPlayerPermissions((SteamID)player.SteamID);
+        }
+
+        /// <summary>
+        /// Temporarily removes all permission flags from a player. These flags are not saved to
+        /// "configs/admins.json".
+        /// </summary>
+        /// <param name="steamId">Steam ID to remove flags from.</param>
+        public static void ClearPlayerPermissions(SteamID steamId)
+        {
+            var data = GetPlayerAdminData(steamId);
+            if (data == null) return;
+
+            data.Flags.Clear();
+            Admins[steamId] = data;
+        }
+        #endregion
+
+        #region Player Immunity
+        /// <summary>
+        /// Sets the immunity value for a player.
+        /// </summary>
+        /// <param name="player">Player controller.</param>
+        /// <param name="value">New immunity value.</param>
+        public static void SetPlayerImmunity(CCSPlayerController? player, uint value)
+        {
+            if (player == null) return;
+            if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) return;
+
+            SetPlayerImmunity((SteamID)player.SteamID, value);
+        }
+
+        /// <summary>
+        /// Sets the immunity value for a player.
+        /// </summary>
+        /// <param name="steamId">Steam ID of the player.</param>
+        /// <param name="value">New immunity value.</param>
+        public static void SetPlayerImmunity(SteamID steamId, uint value)
+        {
+            var data = GetPlayerAdminData(steamId);
+            if (data == null) return;
+
+            data.Immunity = value;
+            Admins[steamId] = data;
+        }
+
+        /// <summary>
+        /// Checks to see if a player can target another player based on their immunity value.
+        /// </summary>
+        /// <param name="caller">Caller of the command.</param>
+        /// <param name="target">Target of the command.</param>
+        /// <returns></returns>
+        public static bool CanPlayerTarget(CCSPlayerController? caller, CCSPlayerController? target)
+        {
+            // The server console should be able to target everyone.
+            if (caller == null) return true;
+
+            if (target == null) return false;
+            if (!target.IsValid || target.Connected != PlayerConnectedState.PlayerConnected) return false;
+
+            var callerData = GetPlayerAdminData((SteamID)caller.SteamID);
+            if (callerData == null) return false;
+
+            var targetData = GetPlayerAdminData((SteamID)target.SteamID);
+            if (targetData == null) return true;
+
+            return callerData.Immunity >= targetData.Immunity;
+        }
+
+        /// <summary>
+        /// Checks to see if a player can target another player based on their immunity value.
+        /// </summary>
+        /// <param name="caller">Caller of the command.</param>
+        /// <param name="target">Target of the command.</param>
+        /// <returns></returns>
+        public static bool CanPlayerTarget(SteamID caller, SteamID target)
+        {
+            var callerData = GetPlayerAdminData(caller);
+            if (callerData == null) return false;
+
+            var targetData = GetPlayerAdminData(caller);
+            if (targetData == null) return true;
+
+            return callerData.Immunity >= targetData.Immunity;
+        }
+        #endregion
+    }
+}

managed/CounterStrikeSharp.API/Modules/Admin/BaseRequiresPermissions.cs

@@ -0,0 +1,44 @@
+using CounterStrikeSharp.API.Core;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using CounterStrikeSharp.API.Modules.Entities;
+
+namespace CounterStrikeSharp.API.Modules.Admin
+{
+    public class BaseRequiresPermissions : Attribute
+    {
+        /// <summary>
+        /// The permissions for the command.
+        /// </summary>
+        public string[] Permissions { get; }
+        /// <summary>
+        /// The name of the command that is attached to this attribute.
+        /// </summary>
+        public string Command { get; set; }
+        /// <summary>
+        /// Whether this attribute should be used for permission checks.
+        /// </summary>
+        public bool Enabled { get; set; }
+
+        public BaseRequiresPermissions(params string[] permissions)
+        {
+            Permissions = permissions;
+            Command = "";
+        }
+
+        public virtual bool CanExecuteCommand(CCSPlayerController? caller)
+        {
+            // If we have a command in the "command_overrides" section in "configs/admins.json",
+            // we skip the checks below and just return the defined value.
+            var adminData = AdminManager.GetPlayerAdminData((SteamID)caller.SteamID);
+            if (adminData == null) return false;
+            if (adminData.CommandOverrides.ContainsKey(Command))
+            {
+                return adminData.CommandOverrides[Command];
+            }
+
+            return true;
+        }
+    }
+}

managed/CounterStrikeSharp.API/Modules/Admin/PermissionCharacters.cs

@@ -0,0 +1,16 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+using System.Threading.Tasks;
+
+namespace CounterStrikeSharp.API.Modules.Admin
+{
+    public class PermissionCharacters
+    {
+        // Example: "#css/admin"
+        public const char GroupPermissionChar = '#';
+        // Example: "@css/manipulate_players"
+        public const char UserPermissionChar = '@';
+    }
+}

managed/CounterStrikeSharp.API/Modules/Admin/RequiresPermissions.cs

@@ -1,15 +1,33 @@
-using System;
+using CounterStrikeSharp.API.Core;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using CounterStrikeSharp.API.Modules.Entities;
 
 namespace CounterStrikeSharp.API.Modules.Admin
 {
-    [AttributeUsage(AttributeTargets.Method)]
-    public class RequiresPermissions : Attribute
-    {
-        public string[] RequiredPermissions { get; }
 
-        public RequiresPermissions(params string[] permissions)
+    [AttributeUsage(AttributeTargets.Method, AllowMultiple = true, Inherited = true)]
+    public class RequiresPermissions : BaseRequiresPermissions
+    {
+        public RequiresPermissions(params string[] permissions) : base(permissions) { }
+
+        public override bool CanExecuteCommand(CCSPlayerController? caller)
         {
-            RequiredPermissions = permissions;
+            if (caller == null) return true;
+            if (AdminManager.PlayerHasCommandOverride(caller, Command))
+            {
+                return AdminManager.GetPlayerCommandOverrideState(caller, Command);
+            }
+            if (!base.CanExecuteCommand(caller)) return false;
+
+            var groupPermissions = Permissions.Where(perm => perm.StartsWith(PermissionCharacters.GroupPermissionChar));
+            var userPermissions = Permissions.Where(perm => perm.StartsWith(PermissionCharacters.UserPermissionChar));
+
+            if (!AdminManager.PlayerInGroup(caller, groupPermissions.ToArray())) return false;
+            if (!AdminManager.PlayerHasPermissions(caller, userPermissions.ToArray())) return false;
+
+            return true;
         }
     }
 }

managed/CounterStrikeSharp.API/Modules/Admin/RequiresPermissionsOr.cs

@@ -0,0 +1,31 @@
+using CounterStrikeSharp.API.Core;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using CounterStrikeSharp.API.Modules.Entities;
+
+namespace CounterStrikeSharp.API.Modules.Admin
+{
+    [AttributeUsage(AttributeTargets.Method, AllowMultiple = true, Inherited = true)]
+    public class RequiresPermissionsOr : BaseRequiresPermissions
+    {
+        public RequiresPermissionsOr(params string[] permissions) : base(permissions) { }
+
+        public override bool CanExecuteCommand(CCSPlayerController? caller)
+        {
+            if (caller == null) return true;
+            if (AdminManager.PlayerHasCommandOverride(caller, Command))
+            {
+                return AdminManager.GetPlayerCommandOverrideState(caller, Command);
+            }
+            if (!base.CanExecuteCommand(caller)) return false;
+
+            var groupPermissions = Permissions.Where(perm => perm.StartsWith(PermissionCharacters.GroupPermissionChar));
+            var userPermissions = Permissions.Where(perm => perm.StartsWith(PermissionCharacters.UserPermissionChar));
+
+            var adminData = AdminManager.GetPlayerAdminData((SteamID)caller.SteamID);
+            if (adminData == null) return false;
+            return (groupPermissions.Intersect(adminData.Groups).Count() + userPermissions.Intersect(adminData.Flags).Count()) > 0;
+        }
+    }
+}

managed/CounterStrikeSharp.API/Modules/Entities/Constants/RoundEndReason.cs

@@ -0,0 +1,44 @@
+/*
+ *  This file is part of CounterStrikeSharp.
+ *  CounterStrikeSharp 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.
+ *
+ *  CounterStrikeSharp 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.
+ *
+ *  You should have received a copy of the GNU General Public License
+ *  along with CounterStrikeSharp.  If not, see <https://www.gnu.org/licenses/>. *
+ */
+
+namespace CounterStrikeSharp.API.Modules.Entities.Constants
+{
+    public enum RoundEndReason : uint
+    {
+        Unknown = 0x0u,
+        TargetBombed = 0x1u,
+        TerroristsEscaped = 0x4u,
+        CTsPreventEscape = 0x5u,
+        EscapingTerroristsNeutralized = 0x6u,
+        BombDefused = 0x7u,
+        CTsWin = 0x8u,
+        TerroristsWin = 0x9u,
+        RoundDraw = 0xAu,
+        AllHostageRescued = 0xBu,
+        TargetSaved = 0xCu,
+        HostagesNotRescued = 0xDu,
+        TerroristsNotEscaped = 0xEu,
+        GameCommencing = 0x10u,
+
+        TerroristsSurrender = 0x11u, // this also triggers match cancelled
+        CTsSurrender = 0x12u, // this also triggers match cancelled
+
+        TerroristsPlanned = 0x13u,
+        CTsReachedHostage = 0x14u,
+        SurvivalWin = 0x15u,
+        SurvivalDraw = 0x16u
+    }
+}

managed/CounterStrikeSharp.API/Modules/Events/GameEvent.cs

@@ -123,6 +123,7 @@ namespace CounterStrikeSharp.API.Modules.Events
         protected void SetEntityIndex(string name, int value) => NativeAPI.SetEventEntityIndex(Handle, name, value);
 
         public void FireEvent(bool dontBroadcast) => NativeAPI.FireEvent(Handle, dontBroadcast);
-        // public void FireEventToClient(int clientId, bool dontBroadcast) => NativeAPI.FireEventToClient(Handle, clientId);
+        
+        public void FireEventToClient(CCSPlayerController player) => NativeAPI.FireEventToClient(Handle, (int)player.EntityIndex.Value.Value);
     }
 }

managed/CounterStrikeSharp.API/Modules/Memory/VirtualFunctions.cs

@@ -1,5 +1,6 @@
 using System;
 using CounterStrikeSharp.API.Core;
+using CounterStrikeSharp.API.Modules.Entities.Constants;
 using CounterStrikeSharp.API.Modules.Utils;
 
 namespace CounterStrikeSharp.API.Modules.Memory;
@@ -27,4 +28,10 @@ public static class VirtualFunctions
 
     // void(*CBaseModelEntity_SetModel)(CBaseModelEntity*, const char*);
     public static Action<IntPtr, string> SetModel = VirtualFunction.CreateVoid<IntPtr, string>(GameData.GetSignature("CBaseModelEntity_SetModel"));
+
+    public static Action<IntPtr, RoundEndReason, float> TerminateRound = VirtualFunction.CreateVoid<nint, RoundEndReason, float>(GameData.GetSignature("CCSGameRules_TerminateRound"));
+
+    public static Func<string, int, IntPtr> UTIL_CreateEntityByName = VirtualFunction.Create<string, int, IntPtr>(GameData.GetSignature("UTIL_CreateEntityByName"));
+
+    public static Action<IntPtr, IntPtr> CBaseEntity_DispatchSpawn = VirtualFunction.CreateVoid<IntPtr, IntPtr>(GameData.GetSignature("CBaseEntity_DispatchSpawn"));
 }

managed/CounterStrikeSharp.API/Modules/Utils/StandaloneCommand.cs

@@ -16,6 +16,42 @@ public class CommandUtils
             var command = new CommandInfo(ptr, caller);
 
             var methodInfo = handler?.GetMethodInfo();
+
+            if (!AdminManager.CommandIsOverriden(name))
+            {
+                // Do not execute command if we do not have the correct permissions.
+                var permissions = methodInfo?.GetCustomAttributes<BaseRequiresPermissions>();
+                if (permissions != null)
+                {
+                    foreach (var attr in permissions)
+                    {
+                        attr.Command = name;
+                        if (!attr.CanExecuteCommand(caller))
+                        {
+                            command.ReplyToCommand("[CSS] You do not have the correct permissions to execute this command.");
+                            return;
+                        }
+                    }
+                }
+            }
+            // If this command has it's permissions overriden, we will do an AND check for all permissions.
+            else
+            {
+                // I don't know if this is the most sane implementation of this, can be edited in code review.
+                var data = AdminManager.GetCommandOverrideData(name);
+                if (data != null) 
+                {
+                    var attrType = (data.CheckType == "all") ? typeof(RequiresPermissions) : typeof(RequiresPermissionsOr);
+                    var attr = (BaseRequiresPermissions)Activator.CreateInstance(attrType, args: AdminManager.GetPermissionOverrides(name));
+                    attr.Command = name;
+                    if (!attr.CanExecuteCommand(caller))
+                    {
+                        command.ReplyToCommand("[CSS] You do not have the correct permissions to execute this command.");
+                        return;
+                    }
+                }
+            }
+
             // Do not execute if we shouldn't be calling this command.
             var helperAttribute = methodInfo?.GetCustomAttribute<CommandHelperAttribute>();
             if (helperAttribute != null)
@@ -41,14 +77,6 @@ public class CommandUtils
                 }
             }
 
-            // Do not execute command if we do not have the correct permissions.
-            var permissions = methodInfo?.GetCustomAttribute<RequiresPermissions>()?.RequiredPermissions;
-            if (permissions != null && !AdminManager.PlayerHasPermissions(caller, permissions))
-            {
-                command.ReplyToCommand("[CSS] You do not have the correct permissions to execute this command.");
-                return;
-            }
-
             handler?.Invoke(caller, command);
         });
 

managed/CounterStrikeSharp.API/Utilities.cs

@@ -15,6 +15,7 @@
  */
 
 using CounterStrikeSharp.API.Core;
+using CounterStrikeSharp.API.Modules.Memory;
 using CounterStrikeSharp.API.Modules.Utils;
 using System;
 using System.Collections.Generic;
@@ -43,6 +44,11 @@ namespace CounterStrikeSharp.API
             return (T)Activator.CreateInstance(typeof(T), NativeAPI.GetEntityFromIndex(index))!;
         }
 
+        public static T? CreateEntityByName<T>(string name) where T : CBaseEntity
+        {
+            return (T?)Activator.CreateInstance(typeof(T), VirtualFunctions.UTIL_CreateEntityByName(name, -1));
+        }
+
         public static CCSPlayerController GetPlayerFromIndex(int index)
         {
             return Utilities.GetEntityFromIndex<CCSPlayerController>(index);

src/core/globals.cpp

@@ -23,47 +23,46 @@
 #include <public/game/server/iplayerinfo.h>
 #include <public/entity2/entitysystem.h>
 
-
 namespace counterstrikesharp {
 
 namespace modules {
-CModule *engine = nullptr;
-CModule *tier0 = nullptr;
-CModule *server = nullptr;
-CModule *schemasystem = nullptr;
-CModule *vscript = nullptr;
-}  // namespace modules
+CModule* engine = nullptr;
+CModule* tier0 = nullptr;
+CModule* server = nullptr;
+CModule* schemasystem = nullptr;
+CModule* vscript = nullptr;
+} // namespace modules
 
 namespace globals {
-IVEngineServer *engine = nullptr;
-IGameEventManager2 *gameEventManager = nullptr;
-IGameEventSystem *gameEventSystem = nullptr;
-IPlayerInfoManager *playerinfoManager = nullptr;
-IBotManager *botManager = nullptr;
-IServerPluginHelpers *helpers = nullptr;
-IUniformRandomStream *randomStream = nullptr;
-IEngineTrace *engineTrace = nullptr;
-IEngineSound *engineSound = nullptr;
-INetworkStringTableContainer *netStringTables = nullptr;
-CGlobalVars *globalVars = nullptr;
-IFileSystem *fileSystem = nullptr;
-IServerGameDLL *serverGameDll = nullptr;
-IServerGameClients *serverGameClients = nullptr;
-INetworkServerService *networkServerService = nullptr;
-IServerTools *serverTools = nullptr;
-IPhysics *physics = nullptr;
-IPhysicsCollision *physicsCollision = nullptr;
-IPhysicsSurfaceProps *physicsSurfaceProps = nullptr;
-IMDLCache *modelCache = nullptr;
-IVoiceServer *voiceServer = nullptr;
+IVEngineServer* engine = nullptr;
+IGameEventManager2* gameEventManager = nullptr;
+IGameEventSystem* gameEventSystem = nullptr;
+IPlayerInfoManager* playerinfoManager = nullptr;
+IBotManager* botManager = nullptr;
+IServerPluginHelpers* helpers = nullptr;
+IUniformRandomStream* randomStream = nullptr;
+IEngineTrace* engineTrace = nullptr;
+IEngineSound* engineSound = nullptr;
+INetworkStringTableContainer* netStringTables = nullptr;
+CGlobalVars* globalVars = nullptr;
+IFileSystem* fileSystem = nullptr;
+IServerGameDLL* serverGameDll = nullptr;
+IServerGameClients* serverGameClients = nullptr;
+INetworkServerService* networkServerService = nullptr;
+IServerTools* serverTools = nullptr;
+IPhysics* physics = nullptr;
+IPhysicsCollision* physicsCollision = nullptr;
+IPhysicsSurfaceProps* physicsSurfaceProps = nullptr;
+IMDLCache* modelCache = nullptr;
+IVoiceServer* voiceServer = nullptr;
 CDotNetManager dotnetManager;
-ICvar *cvars = nullptr;
-ISource2Server *server = nullptr;
-CGlobalEntityList *globalEntityList = nullptr;
-CounterStrikeSharpMMPlugin *mmPlugin = nullptr;
+ICvar* cvars = nullptr;
+ISource2Server* server = nullptr;
+CGlobalEntityList* globalEntityList = nullptr;
+CounterStrikeSharpMMPlugin* mmPlugin = nullptr;
 SourceHook::Impl::CSourceHookImpl source_hook_impl;
-SourceHook::ISourceHook *source_hook = &source_hook_impl;
-ISmmAPI *ismm = nullptr;
+SourceHook::ISourceHook* source_hook = &source_hook_impl;
+ISmmAPI* ismm = nullptr;
 CGameEntitySystem* entitySystem = nullptr;
 CCoreConfig* coreConfig = nullptr;
 CGameConfig* gameConfig = nullptr;
@@ -78,7 +77,10 @@ EntityManager entityManager;
 ChatManager chatManager;
 ServerManager serverManager;
 
-void Initialize() {
+GetLegacyGameEventListener_t* GetLegacyGameEventListener = nullptr;
+
+void Initialize()
+{
     modules::engine = new modules::CModule(ROOTBIN, "engine2");
     modules::tier0 = new modules::CModule(ROOTBIN, "tier0");
     modules::server = new modules::CModule(GAMEBIN, "server");
@@ -89,14 +91,18 @@ void Initialize() {
 
     entitySystem = interfaces::pGameResourceServiceServer->GetGameEntitySystem();
 
+    GetLegacyGameEventListener = reinterpret_cast<GetLegacyGameEventListener_t*>(modules::server->FindSignature(
+            globals::gameConfig->GetSignature("LegacyGameEventListener")));
+
     if (int offset = -1; (offset = gameConfig->GetOffset("GameEventManager")) != -1) {
         gameEventManager = (IGameEventManager2*)(CALL_VIRTUAL(uintptr_t, offset, server) - 8);
     }
 }
 
 int source_hook_pluginid = 0;
-CGlobalVars *getGlobalVars() {
-    INetworkGameServer *server = networkServerService->GetIGameServer();
+CGlobalVars* getGlobalVars()
+{
+    INetworkGameServer* server = networkServerService->GetIGameServer();
 
     if (!server) {
         return nullptr;
@@ -105,5 +111,5 @@ CGlobalVars *getGlobalVars() {
     return networkServerService->GetIGameServer()->GetGlobals();
 }
 
-}  // namespace globals
-}  // namespace counterstrikesharp
+} // namespace globals
+} // namespace counterstrikesharp

src/core/globals.h

@@ -33,6 +33,7 @@ class ICvar;
 class IGameEventSystem;
 class CounterStrikeSharpMMPlugin;
 class CGameEntitySystem;
+class IGameEventListener2;
 
 namespace counterstrikesharp {
 class EntityListener;
@@ -103,6 +104,10 @@ extern ISmmAPI *ismm;
 extern CCoreConfig* coreConfig;
 extern CGameConfig* gameConfig;
 
+typedef IGameEventListener2 *GetLegacyGameEventListener_t(CPlayerSlot slot);
+
+extern GetLegacyGameEventListener_t* GetLegacyGameEventListener;
+
 void Initialize();
 // Should only be called within the active game loop (i e map should be loaded
 // and active) otherwise that'll be nullptr!

src/core/managers/con_command_manager.cpp

@@ -364,7 +364,7 @@ HookResult ConCommandManager::ExecuteCommandCallbacks(const char* name, const CC
         auto thisResult = pCallback->ScriptContext().GetResult<HookResult>();
 
         if (thisResult >= HookResult::Handled) {
-            return result;
+            return thisResult;
         } else if (thisResult > result) {
             result = thisResult;
         }

src/scripting/natives/natives_events.cpp

@@ -18,6 +18,7 @@
 
 #include "core/managers/event_manager.h"
 #include "scripting/autonative.h"
+#include "igameevents.h"
 
 
 namespace counterstrikesharp {
@@ -61,24 +62,21 @@ static void FireEvent(ScriptContext &script_context) {
     managed_game_events.erase(std::remove(managed_game_events.begin(), managed_game_events.end(), game_event), managed_game_events.end());
 }
 
-// static void FireEventToClient(ScriptContext& script_context) {
-//    auto game_event = script_context.GetArgument<IGameEvent*>(0);
-//    int client = script_context.GetArgument<int>(1);
-//    if (!game_event) {
-//        script_context.ThrowNativeError("Invalid game event");
-//    }
-//
-//    auto base_entity = reinterpret_cast<CBaseEntityWrapper*>(ExcBaseEntityFromIndex(client));
-//    if (!base_entity)
-//    {
-//        script_context.ThrowNativeError("Invalid client index");
-//    }
-//
-//    auto iclient = base_entity->GetIClient();
-//    IGameEventListener2* game_client = (IGameEventListener2*)((intptr_t)iclient - sizeof(void*));
-//
-//    game_client->FireGameEvent(game_event);
-// }
+
+ static void FireEventToClient(ScriptContext& script_context) {
+    auto game_event = script_context.GetArgument<IGameEvent*>(0);
+    int entityIndex = script_context.GetArgument<int>(1);
+    if (!game_event) {
+        script_context.ThrowNativeError("Invalid game event");
+    }
+
+    IGameEventListener2* pListener = globals::GetLegacyGameEventListener(CPlayerSlot(entityIndex - 1));
+    if (!pListener) {
+        script_context.ThrowNativeError("Could not get player event listener");
+    }
+
+    pListener->FireGameEvent(game_event);
+ }
 
 static const char *GetEventName(ScriptContext &script_context) {
     IGameEvent *game_event = script_context.GetArgument<IGameEvent *>(0);
@@ -266,7 +264,7 @@ REGISTER_NATIVES(events, {
     ScriptEngine::RegisterNativeHandler("UNHOOK_EVENT", UnhookEvent);
     ScriptEngine::RegisterNativeHandler("CREATE_EVENT", CreateEvent);
     ScriptEngine::RegisterNativeHandler("FIRE_EVENT", FireEvent);
-    // ScriptEngine::RegisterNativeHandler("FIRE_EVENT_TO_CLIENT", FireEventToClient);
+    ScriptEngine::RegisterNativeHandler("FIRE_EVENT_TO_CLIENT", FireEventToClient);
 
     ScriptEngine::RegisterNativeHandler("GET_EVENT_NAME", GetEventName);
     ScriptEngine::RegisterNativeHandler("GET_EVENT_BOOL", GetEventBool);

src/scripting/natives/natives_events.yaml

@@ -2,7 +2,7 @@ HOOK_EVENT: name:string, callback:func, isPost:bool -> void
 UNHOOK_EVENT: name:string, callback:func, isPost:bool -> void
 CREATE_EVENT: name:string, force:bool -> pointer
 FIRE_EVENT: gameEvent:pointer, dontBroadcast:bool -> void
-# FIRE_EVENT_TO_CLIENT: gameEvent:pointer, clientIndex:int -> void
+FIRE_EVENT_TO_CLIENT: gameEvent:pointer, clientIndex:int -> void
 GET_EVENT_NAME: gameEvent:pointer -> string
 GET_EVENT_BOOL: gameEvent:pointer, name:string -> bool
 GET_EVENT_INT: gameEvent:pointer, name:string -> int