Update 1.0.0

Author: NotZer0Two

.idea/.idea.MegaAPI/.idea/.gitignore

@@ -1,6 +1,30 @@
 namespace MegaAPI.API.Commands;
 
-public class ICommand
+/// <summary>
+/// Command interface.
+/// </summary>
+public interface ICommand
 {
-    
-}
+    /// <summary>
+    /// Gets the name of the command.
+    /// </summary>
+    string Name { get; }
+
+    /// <summary>
+    /// Gets the description of the command.
+    /// </summary>
+    string Description { get; }
+
+    /// <summary>
+    /// Gets the alias of a command.
+    /// </summary>
+    string[] Aliases { get; }
+
+    /// <summary>
+    /// Executes the command.
+    /// </summary>
+    /// <param name="arguments">argument which the player input.</param>
+    /// <param name="response">the response to give to the player.</param>
+    /// <returns>if the command ran.</returns>
+    bool Execute(string[] arguments, out string response);
+}

MegaAPI/API/Commands/ICommand.cs

@@ -1,6 +1,28 @@
 namespace MegaAPI.API.Events.Arguments.Console;
 
-public class ConsoleAddingLineEventArgs
+using System;
+using MegaAPI.API.Events.Arguments.Interfaces;
+
+/// <summary>
+/// Represents the arguments for the <see cref="Handlers.ConsoleEventsHandler.AddingLine"/> event.
+/// </summary>
+public class ConsoleAddingLineEventArgs : EventArgs, IDeniableEvent
 {
-    
-}
+    /// <summary>
+    /// Initializes a new instance of the <see cref="ConsoleAddingLineEventArgs"/> class.
+    /// </summary>
+    /// <param name="line">The line to display.</param>
+    public ConsoleAddingLineEventArgs(string line)
+    {
+        Line = line;
+        IsAllowed = true;
+    }
+
+    /// <summary>
+    /// Gets or sets the line to display.
+    /// </summary>
+    public string Line { get; set; }
+
+    /// <inheritdoc/>
+    public bool IsAllowed { get; set; }
+}

MegaAPI/API/Events/Arguments/Console/ConsoleAddingLineEventArgs.cs

@@ -4,24 +4,31 @@
 using MegaAPI.API.Events.Arguments.Interfaces;
 
 /// <summary>
-/// Represents the arguments for the <see cref="Handlers.ConsoleEventsHandler.AddingLine"/> event.
+/// Represents the arguments for the <see cref="Handlers.ConsoleEventsHandler.ExecutingCommand"/> event.
 /// </summary>
-public class ConsoleExecutingCommand : EventArgs, IDeniableEvent
+public class ConsoleExecutingCommandEventArgs : EventArgs, IDeniableEvent
 {
     /// <summary>
-    /// Initializes a new instance of the <see cref="ConsoleExecutingCommand"/> class.
+    /// Initializes a new instance of the <see cref="ConsoleExecutingCommandEventArgs"/> class.
     /// </summary>
-    /// <param name="line">The line to display.</param>
-    public ConsoleExecutingCommand(string line)
+    /// <param name="command">The command the user is trying to run.</param>
+    /// <param name="arguments">The arguments the user is inputting.</param>
+    public ConsoleExecutingCommandEventArgs(string command, string[] arguments)
     {
-        Line = line;
+        Command = command;
+        Arguments = arguments;
         IsAllowed = true;
     }
 
     /// <summary>
-    /// Gets or sets the line to display.
+    /// Gets or sets the command to run.
     /// </summary>
-    public string Line { get; set; }
+    public string Command { get; set; }
+
+    /// <summary>
+    /// Gets or sets the arguments to use.
+    /// </summary>
+    public string[] Arguments { get; set; }
 
     /// <inheritdoc/>
     public bool IsAllowed { get; set; }

MegaAPI/API/Events/Arguments/Console/ConsoleExecutingCommandEventArgs.cs

@@ -1,6 +1,12 @@
 namespace MegaAPI.API.Events.Arguments.Interfaces;
 
-public class IDeniableEvent
+/// <summary>
+/// Represents an event that can be cancelled.
+/// </summary>
+public interface IDeniableEvent
 {
-    
-}
+    /// <summary>
+    /// Gets or sets a value indicating whether the event is allowed to run.
+    /// </summary>
+    public bool IsAllowed { get; set; }
+}

MegaAPI/API/Events/Arguments/Interfaces/IDeniableEvent.cs

@@ -1,15 +1,37 @@
 namespace MegaAPI.API.Events.Handlers;
 
+using MegaAPI.API.Events.Arguments.Console;
+
 /// <summary>
 /// Handles all events related to the console.
 /// </summary>
-public static partial class ConsoleEvents
+public static partial class ConsoleEventsHandler
 {
     /// <summary>
     /// Gets called when <b>any</b> message gets added to the console.
     /// </summary>
     /// <remarks>
     /// This event is called <b>before</b> the console adds the string.
     /// </remarks>
-    public static event MikEventsHandler<ObjectiveCompletingBaseEventArgs>? Completing;
+    public static event MikEventsHandler<ConsoleAddingLineEventArgs> AddingLine;
+
+    /// <summary>
+    /// Gets called when <b>any</b> command gets executed to the console.
+    /// </summary>
+    /// <remarks>
+    /// This event is called <b>before</b> the console process the command.
+    /// </remarks>
+    public static event MikEventsHandler<ConsoleExecutingCommandEventArgs> ExecutingCommand;
+
+    /// <summary>
+    /// Called before sending a cassie message.
+    /// </summary>
+    /// <param name="ev">The <see cref="ConsoleAddingLineEventArgs" /> instance.</param>
+    public static void OnAddingLine(ConsoleAddingLineEventArgs ev) => AddingLine?.Invoke(ev);
+
+    /// <summary>
+    /// Called before sending a cassie message.
+    /// </summary>
+    /// <param name="ev">The <see cref="ConsoleAddingLineEventArgs" /> instance.</param>
+    public static void OnExecutingCommand(ConsoleExecutingCommandEventArgs ev) => ExecutingCommand?.Invoke(ev);
 }

MegaAPI/API/Events/Handlers/ConsoleEventsHandler.cs

@@ -1,6 +1,7 @@
-namespace System.Runtime.CompilerServices.Events;
+namespace MegaAPI.API.Events;
 
-public class MikEventsHandler
-{
-    
-}
+/// <summary>
+/// Miks's event handler.
+/// Called when an event is triggered.
+/// </summary>
+public delegate void MikEventsHandler();

MegaAPI/API/Events/MikEventsHandler.cs

@@ -1,7 +1,12 @@
 namespace MegaAPI.API.Events;
 
+using System;
+
 /// <summary>
-/// LabAPI's event handler.
-/// Called when an event is triggered.
+/// Miks's event handler with a <see cref="EventArgs"/> parameter.
+/// Called when an event is with the specified <see cref="EventArgs"/> triggered .
 /// </summary>
-public delegate void MikEventsHandler();
+/// <param name="ev">The event arg instance.</param>
+/// <typeparam name="TEventArgs">The type of the <see cref="EventArgs"/> of the event.</typeparam>
+public delegate void MikEventsHandler<in TEventArgs>(TEventArgs ev)
+    where TEventArgs : EventArgs;

MegaAPI/API/Events/MikEventsHandler{TEventArgs}.cs

@@ -1,6 +1,37 @@
-namespace MegaAPI.API;
+#pragma warning disable SA1600
+#pragma warning disable SA1402
 
-public class NullableAttribute
+namespace System.Runtime.CompilerServices
 {
-    
-}
+    [AttributeUsage(AttributeTargets.Parameter | AttributeTargets.Property | AttributeTargets.ReturnValue | AttributeTargets.Field | AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.GenericParameter)]
+    internal sealed class NullableAttribute : Attribute
+    {
+        public readonly byte[] NullableFlags;
+
+        public NullableAttribute(byte nullableFlag)
+        {
+            NullableFlags = new byte[] { nullableFlag };
+        }
+
+        public NullableAttribute(byte[] nullableFlags)
+        {
+            NullableFlags = nullableFlags;
+        }
+    }
+
+    [AttributeUsage(AttributeTargets.Module | AttributeTargets.Class | AttributeTargets.Struct | AttributeTargets.Interface | AttributeTargets.Delegate | AttributeTargets.Enum)]
+    internal sealed class NullableContextAttribute : Attribute
+    {
+        public readonly byte Flag;
+
+        public NullableContextAttribute(byte flag)
+        {
+            Flag = flag;
+        }
+    }
+
+    [AttributeUsage(AttributeTargets.Assembly)]
+    internal sealed class NullablePublicOnlyAttribute : Attribute
+    {
+    }
+}

MegaAPI/API/NullableAttribute.cs

@@ -1,6 +1,23 @@
 namespace MegaAPI.Command;
 
-public class BuildVersionCommand
+using MegaAPI.API.Commands;
+
+/// <inheritdoc />
+public class BuildVersionCommand : ICommand
 {
-    
-}
+    /// <inheritdoc />
+    public string Name { get; } = "buildversion";
+
+    /// <inheritdoc />
+    public string Description { get; } = "the version of the mod loader";
+
+    /// <inheritdoc />
+    public string[] Aliases { get; } = ["buildinfo", "build"];
+
+    /// <inheritdoc />
+    public bool Execute(string[] arguments, out string response)
+    {
+        response = $"Currently running MegaAPI v{MegaAPIPlugin.Instance.Info.Version}";
+        return true;
+    }
+}