From 3da9472431516a2947e23882e00697acb296b364 Mon Sep 17 00:00:00 2001
From: VALERA771 <72030575+VALERA771@users.noreply.github.com>
Date: Tue, 16 Jun 2026 22:19:59 +0300
Subject: [PATCH 1/3] feat: command args feature

---
 .../Exiled.API/Features/Core/CommandArgs.cs   | 180 ++++++++++++++++++
 1 file changed, 180 insertions(+)
 create mode 100644 EXILED/Exiled.API/Features/Core/CommandArgs.cs

diff --git a/EXILED/Exiled.API/Features/Core/CommandArgs.cs b/EXILED/Exiled.API/Features/Core/CommandArgs.cs
new file mode 100644
index 0000000000..518ddb7a90
--- /dev/null
+++ b/EXILED/Exiled.API/Features/Core/CommandArgs.cs
@@ -0,0 +1,180 @@
+// -----------------------------------------------------------------------
+// <copyright file="CommandArgs.cs" company="ExMod Team">
+// Copyright (c) ExMod Team. All rights reserved.
+// Licensed under the CC BY-SA 3.0 license.
+// </copyright>
+// -----------------------------------------------------------------------
+
+using System.Globalization;
+
+namespace Exiled.API.Features.Core
+{
+    using System;
+    using System.Linq;
+    using System.Text.RegularExpressions;
+
+    /// <summary>
+    /// A helper class to easily access command arguments.
+    /// </summary>
+    public class CommandArgs
+    {
+        private readonly string[] args;
+        private readonly CultureInfo cultureInfo;
+
+        /// <summary>
+        /// Initializes a new instance of the <see cref="CommandArgs"/> class.
+        /// </summary>
+        /// <param name="args">Parsed command arguments.</param>
+        /// <param name="cultureInfo">Current culture info. Used for float conversions.</param>
+        internal CommandArgs(string[] args, CultureInfo cultureInfo)
+        {
+            this.args = args;
+            this.cultureInfo = cultureInfo;
+        }
+
+        /// <summary>
+        /// Parses an instance of <see cref="CommandArgs"/> from an array of arguments.
+        /// </summary>
+        /// <param name="arguments">Array of arguments.</param>
+        /// <param name="useRegex">Whether the regex should be used.</param>
+        /// <param name="cultureInfo"><see cref="CultureInfo"/> to be used with float-pointing number conversions.</param>
+        /// <returns>An instance of <see cref="CommandArgs"/>.</returns>
+        /// <remarks>
+        /// Usage of <paramref name="useRegex"/> allows to separate arguments not by space char, but also with quotes.
+        /// For example, command with structure
+        /// <code>commandName one "two three" four</code>
+        /// will be separated into
+        /// <code>{ "one", "two three", "four" }</code>
+        /// </remarks>
+        public static CommandArgs Parse(ArraySegment<string> arguments, bool useRegex = false, CultureInfo cultureInfo = null)
+        {
+            if (!useRegex)
+                return new(arguments.Array, cultureInfo ?? CultureInfo.CurrentCulture);
+
+            string[] result = Regex.Matches(string.Join(" ", arguments), @"""([^""]*)""|(\S+)")
+                .Select(m => m.Groups[1].Success ? m.Groups[1].Value : m.Value)
+                .ToArray();
+
+            return new(result, cultureInfo ?? CultureInfo.CurrentCulture);
+        }
+
+        /// <summary>
+        /// Gets a value as an <see cref="int"/> from specified position.
+        /// </summary>
+        /// <param name="index">Index of an argument.</param>
+        /// <returns>Returned value or <c>null</c>.</returns>
+        public int GetInt(uint index) => GetValue<int>(index);
+
+        /// <summary>
+        /// Gets a value as a <see cref="float"/> from specified position.
+        /// </summary>
+        /// <param name="index">Index of an argument.</param>
+        /// <returns>Returned value or <c>null</c>.</returns>
+        public float GetFloat(uint index) => GetValue<float>(index);
+
+        /// <summary>
+        /// Gets a value as a <see cref="Player"/> from specified position.
+        /// </summary>
+        /// <param name="index">Index of an argument.</param>
+        /// <returns>Returned value or <c>null</c>.</returns>
+        public Player GetPlayer(uint index) => Player.Get(GetString(index));
+
+        /// <summary>
+        /// Gets a value as a <see cref="string"/> from specified position.
+        /// </summary>
+        /// <param name="index">Index of an argument.</param>
+        /// <returns>Returned value or <c>null</c>.</returns>
+        public string GetString(uint index)
+        {
+            if (index >= args.Length)
+                return null;
+
+            return args[index];
+        }
+
+        /// <summary>
+        /// Tries to get a value as an <see cref="int"/> from specified position.
+        /// </summary>
+        /// <param name="index">Index of an argument.</param>
+        /// <param name="result">Returned value. May be <c>null</c>.</param>
+        /// <returns><c>true</c> if succeeded. Otherwise, <c>false</c>.</returns>
+        public bool TryGetInt(uint index, out int result) => TryGetValue(index, out result);
+
+        /// <summary>
+        /// Tries to get a value as an <see cref="float"/> from specified position.
+        /// </summary>
+        /// <param name="index">Index of an argument.</param>
+        /// <param name="result">Returned value. May be <c>null</c>.</param>
+        /// <returns><c>true</c> if succeeded. Otherwise, <c>false</c>.</returns>
+        public bool GetFloat(uint index, out float result) => TryGetValue(index, out result);
+
+        /// <summary>
+        /// Tries to get a value as an <see cref="Player"/> from specified position.
+        /// </summary>
+        /// <param name="index">Index of an argument.</param>
+        /// <param name="result">Returned value. May be <c>null</c>.</param>
+        /// <returns><c>true</c> if succeeded. Otherwise, <c>false</c>.</returns>
+        public bool TryGetPlayer(uint index, out Player result) => (result = GetPlayer(index)) != null;
+
+        /// <summary>
+        /// Tries to get a value as an <see cref="string"/> from specified position.
+        /// </summary>
+        /// <param name="index">Index of an argument.</param>
+        /// <param name="result">Returned value. May be <c>null</c>.</param>
+        /// <returns><c>true</c> if succeeded. Otherwise, <c>false</c>.</returns>
+        public bool TryGetString(uint index, out string result) => (result = GetString(index)) != null;
+
+        /// <summary>
+        /// Gets a value as a generic type.
+        /// </summary>
+        /// <param name="index">Index of a value.</param>
+        /// <typeparam name="T">Type of object to be casted to.</typeparam>
+        /// <returns>Casted value or <c>null</c>.</returns>
+        public T GetValue<T>(uint index)
+        {
+            if (index >= args.Length)
+                return default(T);
+
+            try
+            {
+                return (T)Convert.ChangeType(args[index], typeof(T), cultureInfo);
+            }
+            catch (InvalidCastException)
+            {
+                return default(T);
+            }
+        }
+
+        /// <summary>
+        /// Gets a value as a generic type.
+        /// </summary>
+        /// <param name="index">Index of a value.</param>
+        /// <param name="result">Casted value.</param>
+        /// <typeparam name="T">Type of object to be casted to.</typeparam>
+        /// <returns><c>true</c> if value of specific type was successfully retrieved. Otherwise, <c>false</c>.</returns>
+        public bool TryGetValue<T>(uint index, out T result)
+        {
+            result = default(T);
+
+            if (index >= args.Length)
+                return false;
+
+            object value;
+
+            try
+            {
+                value = Convert.ChangeType(args[index], typeof(T), cultureInfo);
+            }
+            catch (InvalidCastException)
+            {
+                return false;
+            }
+
+            if (value == null)
+                return false;
+
+            result = (T)value;
+            return true;
+        }
+    }
+}
\ No newline at end of file

From 4550134c0754bf798afe1c551b181e2b15aa5ca2 Mon Sep 17 00:00:00 2001
From: VALERA771 <72030575+VALERA771@users.noreply.github.com>
Date: Tue, 16 Jun 2026 22:29:49 +0300
Subject: [PATCH 2/3] fix: rename TryGetFloat

---
 EXILED/Exiled.API/Features/Core/CommandArgs.cs | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/EXILED/Exiled.API/Features/Core/CommandArgs.cs b/EXILED/Exiled.API/Features/Core/CommandArgs.cs
index 518ddb7a90..1be7cd48ce 100644
--- a/EXILED/Exiled.API/Features/Core/CommandArgs.cs
+++ b/EXILED/Exiled.API/Features/Core/CommandArgs.cs
@@ -106,7 +106,7 @@ public string GetString(uint index)
         /// <param name="index">Index of an argument.</param>
         /// <param name="result">Returned value. May be <c>null</c>.</param>
         /// <returns><c>true</c> if succeeded. Otherwise, <c>false</c>.</returns>
-        public bool GetFloat(uint index, out float result) => TryGetValue(index, out result);
+        public bool TryGetFloat(uint index, out float result) => TryGetValue(index, out result);
 
         /// <summary>
         /// Tries to get a value as an <see cref="Player"/> from specified position.

From a687f5a7f458059ceb79598d04a9e3e4fdbbab55 Mon Sep 17 00:00:00 2001
From: "@Someone" <45270312+Someone-193@users.noreply.github.com>
Date: Wed, 1 Jul 2026 19:37:31 -0400
Subject: [PATCH 3/3] fix

---
 .../Exiled.API/Features/Core/CommandArgs.cs   | 24 +++++++------------
 1 file changed, 8 insertions(+), 16 deletions(-)

diff --git a/EXILED/Exiled.API/Features/Core/CommandArgs.cs b/EXILED/Exiled.API/Features/Core/CommandArgs.cs
index 1be7cd48ce..85ce818573 100644
--- a/EXILED/Exiled.API/Features/Core/CommandArgs.cs
+++ b/EXILED/Exiled.API/Features/Core/CommandArgs.cs
@@ -5,11 +5,10 @@
 // </copyright>
 // -----------------------------------------------------------------------
 
-using System.Globalization;
-
 namespace Exiled.API.Features.Core
 {
     using System;
+    using System.Globalization;
     using System.Linq;
     using System.Text.RegularExpressions;
 
@@ -40,22 +39,21 @@ internal CommandArgs(string[] args, CultureInfo cultureInfo)
         /// <param name="cultureInfo"><see cref="CultureInfo"/> to be used with float-pointing number conversions.</param>
         /// <returns>An instance of <see cref="CommandArgs"/>.</returns>
         /// <remarks>
-        /// Usage of <paramref name="useRegex"/> allows to separate arguments not by space char, but also with quotes.
-        /// For example, command with structure
+        /// Usage of <paramref name="useRegex"/> allows to separate arguments not by space char, but also with quotes. For example, command with structure:
         /// <code>commandName one "two three" four</code>
-        /// will be separated into
+        /// will be separated into:
         /// <code>{ "one", "two three", "four" }</code>
         /// </remarks>
         public static CommandArgs Parse(ArraySegment<string> arguments, bool useRegex = false, CultureInfo cultureInfo = null)
         {
             if (!useRegex)
-                return new(arguments.Array, cultureInfo ?? CultureInfo.CurrentCulture);
+                return new CommandArgs(arguments.Array, cultureInfo ?? CultureInfo.CurrentCulture);
 
             string[] result = Regex.Matches(string.Join(" ", arguments), @"""([^""]*)""|(\S+)")
                 .Select(m => m.Groups[1].Success ? m.Groups[1].Value : m.Value)
                 .ToArray();
 
-            return new(result, cultureInfo ?? CultureInfo.CurrentCulture);
+            return new CommandArgs(result, cultureInfo ?? CultureInfo.CurrentCulture);
         }
 
         /// <summary>
@@ -84,13 +82,7 @@ public static CommandArgs Parse(ArraySegment<string> arguments, bool useRegex =
         /// </summary>
         /// <param name="index">Index of an argument.</param>
         /// <returns>Returned value or <c>null</c>.</returns>
-        public string GetString(uint index)
-        {
-            if (index >= args.Length)
-                return null;
-
-            return args[index];
-        }
+        public string GetString(uint index) => index >= args.Length ? null : args[index];
 
         /// <summary>
         /// Tries to get a value as an <see cref="int"/> from specified position.
@@ -128,7 +120,7 @@ public string GetString(uint index)
         /// Gets a value as a generic type.
         /// </summary>
         /// <param name="index">Index of a value.</param>
-        /// <typeparam name="T">Type of object to be casted to.</typeparam>
+        /// <typeparam name="T">Type of object to be cast to.</typeparam>
         /// <returns>Casted value or <c>null</c>.</returns>
         public T GetValue<T>(uint index)
         {
@@ -150,7 +142,7 @@ public T GetValue<T>(uint index)
         /// </summary>
         /// <param name="index">Index of a value.</param>
         /// <param name="result">Casted value.</param>
-        /// <typeparam name="T">Type of object to be casted to.</typeparam>
+        /// <typeparam name="T">Type of object to be cast to.</typeparam>
         /// <returns><c>true</c> if value of specific type was successfully retrieved. Otherwise, <c>false</c>.</returns>
         public bool TryGetValue<T>(uint index, out T result)
         {