koishi-plugin-minecraft-search 2.0.2 → 2.0.3

package/lib/index.d.ts

@@ -16,10 +16,13 @@ export interface ApiKeyConfig {
     userId: string;
     groupId: string;
     apiKey: string;
+    allowMemberPowerCommands: boolean;
 }
 export interface Config {
     minekuaiApiUrl: string;
     showIpInDetail: boolean;
+    enablePermissionCheck: boolean;
+    allowMemberPowerCommands: boolean;
 }
 export declare const Config: Schema<Config>;
 export declare const inject: {

package/lib/index.js

@@ -48,7 +48,11 @@ var Config = import_koishi.Schema.intersect([
   }).description("麦块联机配置"),
   import_koishi.Schema.object({
     showIpInDetail: import_koishi.Schema.boolean().default(true).description("在查询详细状态时显示服务器IP地址")
-  }).description("显示配置")
+  }).description("显示配置"),
+  import_koishi.Schema.object({
+    enablePermissionCheck: import_koishi.Schema.boolean().default(true).description("启用权限检查"),
+    allowMemberPowerCommands: import_koishi.Schema.boolean().default(false).description("允许普通成员使用开服、重启、强制重启指令")
+  }).description("权限配置")
 ]);
 var inject = {
   required: ["database"]
@@ -72,7 +76,8 @@ function apply(ctx, config) {
     id: "unsigned",
     userId: "string",
     groupId: "string",
-    apiKey: "string"
+    apiKey: "string",
+    allowMemberPowerCommands: "boolean"
   }, {
     autoInc: true,
     primary: "id"
@@ -165,6 +170,29 @@ function apply(ctx, config) {
     return server.name || "Minecraft 服务器";
   }
   __name(getServerName, "getServerName");
+  async function checkPermission(session, config2, isPowerCommand = false) {
+    if (!config2.enablePermissionCheck) {
+      return null;
+    }
+    if (isPowerCommand) {
+      if (config2.allowMemberPowerCommands) {
+        const groupId = session.guildId;
+        const apiKeys = await ctx.database.get("minecraft_api_key", { groupId });
+        if (apiKeys && apiKeys.length > 0) {
+          const groupConfig = apiKeys[0];
+          if (groupConfig.allowMemberPowerCommands) {
+            return null;
+          }
+        }
+      }
+    }
+    const memberInfo = session.event?.member?.roles;
+    if (!memberInfo || !memberInfo.some((role) => role.name === "admin" || role.name === "owner" || role.id === "admin" || role.id === "owner")) {
+      return "❌ 仅限管理员和群主使用该指令。";
+    }
+    return null;
+  }
+  __name(checkPermission, "checkPermission");
   function formatShortStatus(result, server) {
     const displayName = getServerName(server);
     if (!result.online) {
@@ -285,6 +313,10 @@ function apply(ctx, config) {
     return formatDetailedStatus(result.data, tempServer, config.showIpInDetail);
   });
   ctx.guild().command("mc/绑定 <host:string>", "绑定Minecraft服务器").option("name", "-n <name:string>", { fallback: "" }).option("timeout", "-t <timeout:number>", { fallback: 5 }).option("instance", "-i <instance:string>", { fallback: "" }).action(async ({ session, options }, host) => {
+    const permissionError = await checkPermission(session, config);
+    if (permissionError) {
+      return permissionError;
+    }
     if (!host) {
       return "请提供服务器地址，例如：绑定+IP地址（不带端口时默认为25565）";
     }
@@ -320,6 +352,10 @@ function apply(ctx, config) {
 名称: ${newServer.name || "Minecraft 服务器"}`;
   });
   ctx.guild().command("mc/绑定密钥 <apiKey:string>", "绑定麦块API密钥").action(async ({ session }, apiKey) => {
+    const permissionError = await checkPermission(session, config);
+    if (permissionError) {
+      return permissionError;
+    }
     if (!apiKey) {
       return "请提供API密钥";
     }
@@ -338,6 +374,10 @@ function apply(ctx, config) {
     return "✅ API密钥绑定成功！";
   });
   ctx.guild().command("mc/解绑 <id:number>", "解绑Minecraft服务器").action(async ({ session }, id) => {
+    const permissionError = await checkPermission(session, config);
+    if (permissionError) {
+      return permissionError;
+    }
     if (!id) {
       return "请提供服务器ID，例如：解绑 1";
     }
@@ -351,6 +391,10 @@ function apply(ctx, config) {
     return `✅ 服务器已解绑`;
   });
   ctx.guild().command("mc/修改 <id:number>", "修改Minecraft服务器信息").option("name", "-n <name:string>", { fallback: "" }).option("timeout", "-t <timeout:number>", { fallback: 0 }).option("instance", "-i <instance:string>", { fallback: "" }).action(async ({ session, options }, id) => {
+    const permissionError = await checkPermission(session, config);
+    if (permissionError) {
+      return permissionError;
+    }
     if (!id) {
       return "请提供服务器ID，例如：修改 1";
     }
@@ -382,6 +426,10 @@ function apply(ctx, config) {
 ${parts.join("\n")}`;
   });
   ctx.guild().command("mc/开服 <id:number>", "启动麦块服务器").action(async ({ session }, id) => {
+    const permissionError = await checkPermission(session, config, true);
+    if (permissionError) {
+      return permissionError;
+    }
     if (!id) return "请提供服务器ID，例如：开服 1";
     const groupId = session.guildId;
     const servers = await ctx.database.get("minecraft_server", { groupId });
@@ -396,6 +444,10 @@ ${parts.join("\n")}`;
     }
   });
   ctx.guild().command("mc/重启 <id:number>", "重启麦块服务器").action(async ({ session }, id) => {
+    const permissionError = await checkPermission(session, config, true);
+    if (permissionError) {
+      return permissionError;
+    }
     if (!id) return "请提供服务器ID，例如：重启 1";
     const groupId = session.guildId;
     const servers = await ctx.database.get("minecraft_server", { groupId });
@@ -410,6 +462,10 @@ ${parts.join("\n")}`;
     }
   });
   ctx.guild().command("mc/强制重启 <id:number>", "强制重启麦块服务器").action(async ({ session }, id) => {
+    const permissionError = await checkPermission(session, config, true);
+    if (permissionError) {
+      return permissionError;
+    }
     if (!id) return "请提供服务器ID，例如：强制重启 1";
     const groupId = session.guildId;
     const servers = await ctx.database.get("minecraft_server", { groupId });
@@ -513,6 +569,10 @@ ${parts.join("\n")}`;
     return message.trim();
   });
   ctx.guild().command("mc/设置实例 <id:number> <instanceId:string>", "设置服务器的麦块实例ID").action(async ({ session }, id, instanceId) => {
+    const permissionError = await checkPermission(session, config);
+    if (permissionError) {
+      return permissionError;
+    }
     if (!id || !instanceId) {
       return "请提供服务器ID和实例ID，例如：设置实例 1 abc123";
     }
@@ -525,6 +585,22 @@ ${parts.join("\n")}`;
     await ctx.database.set("minecraft_server", { id }, { minekuaiInstanceId: instanceId });
     return `✅ ${server.name} 的麦块实例ID已设置为: ${instanceId}`;
   });
+  ctx.guild().command("mc/权限设置 <enabled:boolean>", "开启/关闭普通群成员使用开服、重启和强制重启指令").action(async ({ session }, enabled) => {
+    const permissionError = await checkPermission(session, config);
+    if (permissionError) {
+      return permissionError;
+    }
+    if (!config.allowMemberPowerCommands) {
+      return "❌ 请先在插件配置中开启「允许普通成员使用开服、重启、强制重启指令」选项";
+    }
+    const groupId = session.guildId;
+    const apiKeys = await ctx.database.get("minecraft_api_key", { groupId });
+    if (!apiKeys || apiKeys.length === 0) {
+      return "❌ 本群未配置麦块API密钥，请先使用 绑定密钥 指令";
+    }
+    await ctx.database.set("minecraft_api_key", { groupId }, { allowMemberPowerCommands: enabled });
+    return `✅ 已${enabled ? "开启" : "关闭"}普通群成员使用开服、重启和强制重启指令的权限`;
+  });
 }
 __name(apply, "apply");
 // Annotate the CommonJS export names for ESM import in node:

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "koishi-plugin-minecraft-search",
   "description": "使用API查询基础的mc服务器信息",
-  "version": "2.0.2",
+  "version": "2.0.3",
   "main": "lib/index.js",
   "typings": "lib/index.d.ts",
   "files": [

package/readme.md

@@ -53,7 +53,9 @@ npm install koishi-plugin-minecraft-search
 ```typescript
 {
   "minekuaiApiUrl": "https://minekuai.com/api/client", // 麦块API地址
-  "showIpInDetail": true // 是否在详细状态中显示IP地址
+  "showIpInDetail": true, // 是否在详细状态中显示IP地址
+  "enablePermissionCheck": true, // 启用权限检查
+  "allowMemberPowerCommands": false // 允许普通成员使用开服、重启、强制重启指令
 }
 ```
 
@@ -67,6 +69,7 @@ mc/修改 <id> [-n <name>] [-t <timeout>] [-i <instance>]    # 修改服务器
 mc/服务器列表                              # 查看已绑定的服务器列表
 mc/设置实例 <id> <instanceId>              # 设置服务器的麦块实例ID
 mc/绑定API密钥 <apiKey>                    # 绑定麦块API密钥
+mc/权限设置 <enabled>                      # 开启/关闭普通群成员使用开服、重启和强制重启指令
 ```
 
 ### 查询服务器状态
@@ -138,6 +141,7 @@ mc/资源 1      # 查看ID为1的麦块服务器资源使用情况
 - **`mc/修改 <id> [-n <name>] [-t <timeout>] [-i <instance>]`**：修改服务器名称、超时时间或麦块实例ID
 - **`mc/设置实例 <id> <instanceId>`**：为服务器设置麦块实例ID，用于电源控制
 - **`mc/服务器列表`**：查看当前群组已绑定的所有服务器
+- **`mc/权限设置 <enabled>`**：开启/关闭普通群成员使用开服、重启和强制重启指令，需要先在插件配置中开启 `allowMemberPowerCommands` 选项
 
 ### 服务器控制指令
 - **`mc/开服 <id>`**：启动指定服务器
@@ -153,7 +157,7 @@ mc/资源 1      # 查看ID为1的麦块服务器资源使用情况
 - ⚡ **高性能查询**：支持并行查询多个服务器
 - 🛡️ **错误处理**：完善的错误处理和用户提示
 - 🗄️ **数据库存储**：使用数据库存储服务器配置，支持多群组管理
-- 🔒 **权限控制**：每个群组只能管理自己绑定的服务器
+- 🔒 **权限控制**：支持全局和群组级别的权限管理，每个群组只能管理自己绑定的服务器，可控制普通成员使用电源指令的权限
 - 🌐 **直接IP查询**：支持直接输入IP地址查询服务器状态
 - 🔧 **实例ID管理**：支持在绑定和修改服务器时直接设置麦块实例ID
 
@@ -184,6 +188,13 @@ mc/资源 1      # 查看ID为1的麦块服务器资源使用情况
 <details>
 <summary>点我查看更新日志详情</summary>
 
+### v2.0.3
+- 新增权限检查功能，支持全局权限控制
+- 新增配置项 `enablePermissionCheck` 控制是否启用权限检查
+- 新增配置项 `allowMemberPowerCommands` 控制是否允许普通成员使用电源指令
+- 新增 `mc/权限设置` 指令，用于每个群组独立控制普通成员权限
+- 优化权限检查逻辑，支持群组级别的权限设置
+
 ### v2.0.1
 - 新增绑定服务器时支持 -i 选项直接设置麦块实例ID
 - 新增修改服务器时支持 -i 选项修改麦块实例ID