Add command interfaces

Author: akemimadoka

build.bat

@@ -0,0 +1,6 @@
+@echo off
+cd src
+dotnet restore
+dotnet build
+
+pause

run_gateway.bat

@@ -1,3 +1,4 @@
+@echo off
 cd src\MineCase.Gateway
 start dotnet run
 pause

run_server.bat

@@ -1,3 +1,4 @@
+@echo off
 cd src
 dotnet restore
 dotnet build

src/MineCase.Server.Interfaces/Game/ICommand.cs

@@ -0,0 +1,46 @@
+using System;
+using System.Collections.Generic;
+
+namespace MineCase.Server.Game
+{
+    /// <summary>
+    /// 命令接口
+    /// </summary>
+    public interface ICommand
+    {
+        /// <summary>
+        /// Gets 该命令的名称
+        /// </summary>
+        string Name { get; }
+
+        /// <summary>
+        /// Gets 该命令的描述，可为 null
+        /// </summary>
+        string Description { get; }
+
+        /// <summary>
+        /// Gets 要执行此命令需要的权限，可为 null
+        /// </summary>
+        Permission NeededPermission { get; }
+
+        /// <summary>
+        /// Gets 该命令的别名，可为 null
+        /// </summary>
+        IEnumerable<string> Aliases { get; }
+
+        /// <summary>
+        /// 执行该命令
+        /// </summary>
+        /// <param name="commandSender">发送命令者</param>
+        /// <param name="args">命令的参数</param>
+        /// <returns>执行是否成功，如果成功则返回 true</returns>
+        bool Execute(ICommandSender commandSender, IEnumerable<string> args);
+    }
+
+    /// <summary>
+    /// 可发送命令者接口
+    /// </summary>
+    public interface ICommandSender : IPermissible
+    {
+    }
+}

src/MineCase.Server.Interfaces/Game/IPermissible.cs

@@ -0,0 +1,18 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+
+namespace MineCase.Server.Game
+{
+    /// <summary>
+    /// 具有权限者接口
+    /// </summary>
+    public interface IPermissible
+    {
+        /// <summary>
+        /// 判断是否具有特定的权限
+        /// </summary>
+        /// <param name="permission">要判断的权限</param>
+        bool HasPermission(Permission permission);
+    }
+}

src/MineCase.Server.Interfaces/Game/Permission.cs

@@ -0,0 +1,44 @@
+using System;
+using System.Collections.Generic;
+using System.Linq;
+using System.Text;
+
+namespace MineCase.Server.Game
+{
+    /// <summary>
+    /// 权限
+    /// </summary>
+    public class Permission
+    {
+        /// <summary>
+        /// Gets 该权限的名称
+        /// </summary>
+        public string Name { get; }
+
+        /// <summary>
+        /// Gets 该权限的描述，可为 null
+        /// </summary>
+        public string Description { get; }
+
+        /// <summary>
+        /// Gets or sets 该权限的默认值
+        /// </summary>
+        public PermissionDefaultValue DefaultValue { get; set; }
+
+        private readonly Dictionary<string, Permission> _children;
+
+        public Permission(
+            string name,
+            string description = null,
+            PermissionDefaultValue permissionDefaultValue = PermissionDefaultValue.True,
+            IEnumerable<Permission> children = null)
+        {
+            Name = name ?? throw new ArgumentNullException(nameof(name));
+            Description = description;
+            DefaultValue = permissionDefaultValue;
+            _children = children.ToDictionary(
+                            p => p?.Name ?? throw new ArgumentException("子权限不得为 null", nameof(children))) ??
+                        new Dictionary<string, Permission>();
+        }
+    }
+}

src/MineCase.Server.Interfaces/Game/PermissionDefaultValue.cs

@@ -0,0 +1,27 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+
+namespace MineCase.Server.Game
+{
+    /// <summary>
+    /// 权限 (<see cref="Permission"/>) 的默认值
+    /// </summary>
+    public enum PermissionDefaultValue
+    {
+        /// <summary>
+        /// 对所有人都启用
+        /// </summary>
+        True,
+
+        /// <summary>
+        /// 对 Operator 启用
+        /// </summary>
+        TrueIfOp,
+
+        /// <summary>
+        /// 对所有人都禁用
+        /// </summary>
+        False
+    }
+}

src/MineCase.Server.Interfaces/Game/SimpleCommand.cs

@@ -0,0 +1,32 @@
+using System;
+using System.Collections.Generic;
+using System.Text;
+
+namespace MineCase.Server.Game
+{
+    public abstract class SimpleCommand : ICommand
+    {
+        public string Name { get; }
+
+        public string Description { get; }
+
+        public Permission NeededPermission { get; }
+
+        private readonly HashSet<string> _aliases;
+
+        public IEnumerable<string> Aliases => _aliases;
+
+        protected SimpleCommand(string name, string description = null, Permission neededPermission = null, IEnumerable<string> aliases = null)
+        {
+            Name = name ?? throw new ArgumentNullException(nameof(name));
+            Description = description;
+            NeededPermission = neededPermission;
+            if (aliases != null)
+            {
+                _aliases = new HashSet<string>(aliases);
+            }
+        }
+
+        public abstract bool Execute(ICommandSender commandSender, IEnumerable<string> args);
+    }
+}

src/MineCase.sln

@@ -17,7 +17,7 @@ Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MineCase.Server.Grains", "M
 EndProject
 Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MineCase.UnitTest", "..\tests\UnitTest\MineCase.UnitTest.csproj", "{35618D69-85F0-4C38-8224-04A2D75825B6}"
 EndProject
-Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MineCase.Nbt", "MineCase.NBT\MineCase.Nbt.csproj", "{199335D6-9726-42E1-94F2-7D95932D4DDC}"
+Project("{9A19103F-16F7-4668-BE54-9A1E7A4F7556}") = "MineCase.Nbt", "MineCase.Nbt\MineCase.Nbt.csproj", "{199335D6-9726-42E1-94F2-7D95932D4DDC}"
 EndProject
 Project("{2150E333-8FDC-42A3-9474-1A3956D46DE8}") = "Solution Items", "Solution Items", "{A0B013BF-4BEB-4044-AA59-A9ED3AFBF99D}"
 	ProjectSection(SolutionItems) = preProject

tests/UnitTest/MineCase.UnitTest.csproj

@@ -21,7 +21,7 @@
 
   <ItemGroup>
     <ProjectReference Include="..\..\src\MineCase.Algorithm\MineCase.Algorithm.csproj" />
-    <ProjectReference Include="..\..\src\MineCase.NBT\MineCase.Nbt.csproj" />
+    <ProjectReference Include="..\..\src\MineCase.Nbt\MineCase.Nbt.csproj" />
     <ProjectReference Include="..\..\src\MineCase.Protocol\MineCase.Protocol.csproj" />
   </ItemGroup>