docs: update console command expected usage docs

configs/addons/counterstrikesharp/source/README.txt

@@ -0,0 +1 @@
+Place your source code for plugins here.

docs/src/content/docs/features/admin-framework.md

@@ -24,10 +24,10 @@ You can also manually assign permissions to players in code with `AddPlayerPermi
 
 ## Assigning permissions to a Command
 
-Assigning permissions to a Command is as easy as tagging the Command method (function callback) with a `PermissionHelper` attribute.
+Assigning permissions to a Command is as easy as tagging the Command method (function callback) with a `RequiresPermissions` attribute.
 
 ```csharp
-[PermissionHelper("can_execute_test_command", "other_permission")]
+[RequiresPermissions("can_execute_test_command", "other_permission")]
 public void OnMyCommand(CCSPlayerController? caller, CommandInfo info)
 {
     ...

docs/src/content/docs/features/console-commands.md

@@ -64,3 +64,39 @@ Command String: custom_command "Test Quoted" 5 13
 First Argument: custom_command
 Second Argument: Test Quoted
 ```
+
+## Helper Attribute
+
+CounterStrikeSharp provides the `CommandHelper` attribute for Command methods (function callback) to simplify the process of checking for the correct amount of arguments and to restrict commands to being executed by the server console or by players (or both!).
+
+```csharp
+[ConsoleCommand("freeze", "Freezes a client.")]
+[CommandHelper(minArgs: 1, usage: "[target]", whoCanExecute: CommandUsage.CLIENT_AND_SERVER)]
+public void OnFreezeCommand(CCSPlayerController? caller, CommandInfo command)
+{
+    ...
+}
+```
+
+If a client tries to execute the command without the `[target]` argument, it will print a message to them in chat:
+
+```shell
+[CSS] Expected usage: "!freeze [target]".
+```
+
+If a command is executed by the wrong user, it will print a message to them:
+
+```shell
+[CSS] This command can only be executed by clients.
+```
+
+Valid `CommandUsage` values:
+
+```csharp
+public enum CommandUsage
+{
+    CLIENT_AND_SERVER = 0,
+    CLIENT_ONLY,
+    SERVER_ONLY
+}
+```

managed/CounterStrikeSharp.API/Core/BasePlugin.cs

@@ -184,7 +184,7 @@ namespace CounterStrikeSharp.API.Core
                 }
 
                 // Do not execute command if we do not have the correct permissions.
-                var permissions = methodInfo?.GetCustomAttribute<PermissionHelperAttribute>()?.RequiredPermissions;
+                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.");

managed/CounterStrikeSharp.API/Core/GlobalContext.cs

@@ -183,7 +183,7 @@ namespace CounterStrikeSharp.API.Core
             return plugin;
         }
 
-        [PermissionHelper("can_execute_css_commands")]
+        [RequiresPermissions("can_execute_css_commands")]
         [CommandHelper(whoCanExecute: CommandUsage.CLIENT_AND_SERVER)]
         private void OnCSSCommand(CCSPlayerController? caller, CommandInfo info)
         {
@@ -196,7 +196,7 @@ namespace CounterStrikeSharp.API.Core
             return;
         }
 
-        [PermissionHelper("can_execute_css_commands")]
+        [RequiresPermissions("can_execute_css_commands")]
         [CommandHelper(minArgs: 1, 
         usage: "[option]\n" +
                 "  list - List all plugins currently loaded.\n" +

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

@@ -29,7 +29,7 @@ namespace CounterStrikeSharp.API.Modules.Admin
             CommandUtils.AddStandaloneCommand("css_admins_list", "List admins and their flags.", ListAdminsCommand);
         }
 
-        [PermissionHelper("can_reload_admins")]
+        [RequiresPermissions("can_reload_admins")]
         [CommandHelper(whoCanExecute: CommandUsage.CLIENT_AND_SERVER)]
         private static void ReloadAdminsCommand(CCSPlayerController? player, CommandInfo command)
         {
@@ -38,7 +38,7 @@ namespace CounterStrikeSharp.API.Modules.Admin
             Load(Path.Combine(rootDir.FullName, "configs", "admins.json"));
         }
         
-        [PermissionHelper("can_reload_admins")]
+        [RequiresPermissions("can_reload_admins")]
         [CommandHelper(whoCanExecute: CommandUsage.CLIENT_AND_SERVER)]
         private static void ListAdminsCommand(CCSPlayerController? player, CommandInfo command)
         {
@@ -131,8 +131,17 @@ namespace CounterStrikeSharp.API.Modules.Admin
         {
             if (player == null) return;
             if (!player.IsValid || player.Connected != PlayerConnectedState.PlayerConnected || player.IsBot) return;
-
-            var steamId = new SteamID(player.SteamID);
+            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)
             {
@@ -151,19 +160,30 @@ namespace CounterStrikeSharp.API.Modules.Admin
                 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 add a flag to.</param>
+        /// <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;
 
-            var data = GetPlayerAdminData(new SteamID(player.SteamID));
+            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);

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

@@ -3,11 +3,11 @@
 namespace CounterStrikeSharp.API.Modules.Admin
 {
     [AttributeUsage(AttributeTargets.Method)]
-    public class PermissionHelperAttribute : Attribute
+    public class RequiresPermissions : Attribute
     {
         public string[] RequiredPermissions { get; }
 
-        public PermissionHelperAttribute(params string[] permissions)
+        public RequiresPermissions(params string[] permissions)
         {
             RequiredPermissions = permissions;
         }

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

@@ -42,7 +42,7 @@ public class CommandUtils
             }
 
             // Do not execute command if we do not have the correct permissions.
-            var permissions = methodInfo?.GetCustomAttribute<PermissionHelperAttribute>()?.RequiredPermissions;
+            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.");