koishi-plugin-minecraft-command 1.0.0

package/lib/index.d.ts

@@ -0,0 +1,12 @@
+import { Context, Schema } from 'koishi';
+export declare const name = "minecraft-command";
+export interface Config {
+    botId: string;
+    allowedChannels: string[];
+    allowedUsers: string[];
+    adminUsers: string[];
+    adminAuthority: number;
+    userAuthority: number;
+}
+export declare const Config: Schema<Config>;
+export declare function apply(ctx: Context, config: Config): void;

package/lib/index.js

@@ -0,0 +1,241 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Config = exports.name = void 0;
+exports.apply = apply;
+const koishi_1 = require("koishi");
+exports.name = 'minecraft-command';
+const logger = new koishi_1.Logger('mc-cmd');
+function hasExecuteCommand(bot) {
+    return 'executeCommand' in bot;
+}
+exports.Config = koishi_1.Schema.object({
+    botId: koishi_1.Schema.string()
+        .description('指定 Minecraft Bot ID（selfId），留空则自动选择第一个可用的 Minecraft Bot')
+        .default(''),
+    allowedChannels: koishi_1.Schema.array(koishi_1.Schema.string())
+        .description('允许执行命令的频道/群组 ID 列表（留空则不限制频道）')
+        .default([]),
+    allowedUsers: koishi_1.Schema.array(koishi_1.Schema.string())
+        .description('允许执行普通命令的用户 ID 列表（留空则不限制用户）')
+        .default([]),
+    adminUsers: koishi_1.Schema.array(koishi_1.Schema.string())
+        .description('允许执行管理命令的用户 ID 列表（mc.cmd / mc.tp / mc.give / mc.weather / mc.time）')
+        .default([]),
+    adminAuthority: koishi_1.Schema.number()
+        .description('管理命令所需的 Koishi authority 等级（与 adminUsers 为「或」关系，满足其一即可）')
+        .default(3),
+    userAuthority: koishi_1.Schema.number()
+        .description('普通命令所需的 Koishi authority 等级')
+        .default(1),
+});
+function apply(ctx, config) {
+    function findBot() {
+        for (const bot of ctx.bots) {
+            if (bot.platform !== 'minecraft')
+                continue;
+            if (!hasExecuteCommand(bot))
+                continue;
+            if (config.botId && bot.selfId !== config.botId)
+                continue;
+            return bot;
+        }
+        // 指定了 botId 但未匹配时，fallback 到任意可用的 minecraft bot
+        if (config.botId) {
+            for (const bot of ctx.bots) {
+                if (bot.platform === 'minecraft' && hasExecuteCommand(bot)) {
+                    return bot;
+                }
+            }
+        }
+        return undefined;
+    }
+    async function runCommand(command) {
+        const bot = findBot();
+        if (!bot) {
+            throw new Error('未找到可用的 Minecraft Bot，请确保 minecraft-adapter 插件已启用并连接');
+        }
+        return await bot.executeCommand(command);
+    }
+    function extractAuthority(user) {
+        if (user != null && typeof user === 'object' && 'authority' in user) {
+            return typeof user.authority === 'number' ? user.authority : 0;
+        }
+        return 0;
+    }
+    function checkPermission(channelId, userId, authority, requireAdmin) {
+        if (config.allowedChannels.length > 0) {
+            if (!channelId || !config.allowedChannels.includes(channelId)) {
+                return '此频道不允许执行 Minecraft 命令';
+            }
+        }
+        if (requireAdmin) {
+            // adminUsers 列表 或 authority >= adminAuthority，满足其一即可
+            const inAdminList = userId ? config.adminUsers.includes(userId) : false;
+            const hasAuth = authority >= config.adminAuthority;
+            if (!inAdminList && !hasAuth) {
+                return '你没有权限执行此管理命令';
+            }
+        }
+        else {
+            // allowedUsers 为空则不限制；非空时需在列表中 或 authority 满足要求
+            if (config.allowedUsers.length > 0) {
+                const inUserList = userId ? config.allowedUsers.includes(userId) : false;
+                const hasAuth = authority >= config.userAuthority;
+                if (!inUserList && !hasAuth) {
+                    return '你没有权限执行此命令';
+                }
+            }
+        }
+        return undefined;
+    }
+    ctx.command('mc', 'Minecraft 服务器管理')
+        .usage('通过子命令管理 Minecraft 服务器：mc.list / mc.say / mc.tp / mc.give / mc.weather / mc.time / mc.cmd');
+    ctx.command('mc.list', '查看在线玩家')
+        .alias('mc.在线')
+        .action(async ({ session }) => {
+        if (!session)
+            return;
+        const denied = checkPermission(session.channelId, session.userId, extractAuthority(session.user), false);
+        if (denied)
+            return denied;
+        try {
+            const result = await runCommand('list');
+            return result || '命令已执行，但服务器未返回数据';
+        }
+        catch (e) {
+            logger.warn('mc.list 执行失败', e);
+            return `执行失败: ${e.message}`;
+        }
+    });
+    ctx.command('mc.say <message:text>', '在服务器中广播消息')
+        .alias('mc.广播')
+        .action(async ({ session }, message) => {
+        if (!session)
+            return;
+        const denied = checkPermission(session.channelId, session.userId, extractAuthority(session.user), false);
+        if (denied)
+            return denied;
+        if (!message)
+            return '请输入要广播的消息';
+        try {
+            const result = await runCommand(`say ${message}`);
+            return `广播成功${result ? `: ${result}` : ''}`;
+        }
+        catch (e) {
+            logger.warn('mc.say 执行失败', e);
+            return `广播失败: ${e.message}`;
+        }
+    });
+    ctx.command('mc.tp <player:string> <target:text>', '传送玩家到目标位置或玩家')
+        .alias('mc.传送')
+        .usage('示例:\n  mc.tp Steve Alex        — 将 Steve 传送到 Alex\n  mc.tp Steve 100 64 200  — 将 Steve 传送到坐标')
+        .action(async ({ session }, player, target) => {
+        if (!session)
+            return;
+        const denied = checkPermission(session.channelId, session.userId, extractAuthority(session.user), true);
+        if (denied)
+            return denied;
+        if (!player || !target)
+            return '用法: mc.tp <玩家名> <目标玩家或坐标>';
+        try {
+            const result = await runCommand(`tp ${player} ${target}`);
+            return `传送成功${result ? `: ${result}` : ''}`;
+        }
+        catch (e) {
+            logger.warn('mc.tp 执行失败', e);
+            return `传送失败: ${e.message}`;
+        }
+    });
+    ctx.command('mc.give <player:string> <item:string> [count:number]', '给予玩家物品')
+        .alias('mc.给予')
+        .usage('示例: mc.give Steve diamond 64')
+        .action(async ({ session }, player, item, count) => {
+        if (!session)
+            return;
+        const denied = checkPermission(session.channelId, session.userId, extractAuthority(session.user), true);
+        if (denied)
+            return denied;
+        if (!player || !item)
+            return '用法: mc.give <玩家名> <物品ID> [数量]';
+        const amount = count ?? 1;
+        try {
+            const result = await runCommand(`give ${player} ${item} ${amount}`);
+            return `已给予 ${player} ${amount} 个 ${item}${result ? `\n${result}` : ''}`;
+        }
+        catch (e) {
+            logger.warn('mc.give 执行失败', e);
+            return `给予失败: ${e.message}`;
+        }
+    });
+    ctx.command('mc.weather <type:string>', '设置服务器天气')
+        .alias('mc.天气')
+        .usage('可选值: clear (晴天) / rain (雨天) / thunder (雷暴)')
+        .action(async ({ session }, type) => {
+        if (!session)
+            return;
+        const denied = checkPermission(session.channelId, session.userId, extractAuthority(session.user), true);
+        if (denied)
+            return denied;
+        if (!type)
+            return '请指定天气类型: clear / rain / thunder';
+        const validTypes = ['clear', 'rain', 'thunder'];
+        if (!validTypes.includes(type.toLowerCase())) {
+            return `无效的天气类型，可选值: ${validTypes.join(' / ')}`;
+        }
+        try {
+            const result = await runCommand(`weather ${type.toLowerCase()}`);
+            return `天气已设置为 ${type}${result ? `\n${result}` : ''}`;
+        }
+        catch (e) {
+            logger.warn('mc.weather 执行失败', e);
+            return `设置天气失败: ${e.message}`;
+        }
+    });
+    ctx.command('mc.time <value:string>', '设置服务器时间')
+        .alias('mc.时间')
+        .usage('可选值: day / night / noon / midnight / 游戏刻数字 (如 6000)')
+        .action(async ({ session }, value) => {
+        if (!session)
+            return;
+        const denied = checkPermission(session.channelId, session.userId, extractAuthority(session.user), true);
+        if (denied)
+            return denied;
+        if (!value)
+            return '请指定时间值: day / night / noon / midnight / 游戏刻数字';
+        const presets = ['day', 'night', 'noon', 'midnight'];
+        const isPreset = presets.includes(value.toLowerCase());
+        const isNumber = /^\d+$/.test(value);
+        if (!isPreset && !isNumber) {
+            return `无效的时间值，可选: ${presets.join(' / ')} 或游戏刻数字`;
+        }
+        try {
+            const result = await runCommand(`time set ${isPreset ? value.toLowerCase() : value}`);
+            return `时间已设置为 ${value}${result ? `\n${result}` : ''}`;
+        }
+        catch (e) {
+            logger.warn('mc.time 执行失败', e);
+            return `设置时间失败: ${e.message}`;
+        }
+    });
+    ctx.command('mc.cmd <command:text>', '执行任意 Minecraft 服务器命令')
+        .alias('mc.命令')
+        .usage('直接执行原始服务器命令，如: mc.cmd op Steve')
+        .action(async ({ session }, command) => {
+        if (!session)
+            return;
+        const denied = checkPermission(session.channelId, session.userId, extractAuthority(session.user), true);
+        if (denied)
+            return denied;
+        if (!command)
+            return '请输入要执行的命令';
+        try {
+            const result = await runCommand(command);
+            return result || '命令已执行';
+        }
+        catch (e) {
+            logger.warn('mc.cmd 执行失败', e);
+            return `执行失败: ${e.message}`;
+        }
+    });
+    logger.info('minecraft-command 插件已加载');
+}

package/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "koishi-plugin-minecraft-command",
+  "description": "Execute Minecraft server commands from chat platforms via koishi-plugin-minecraft-adapter",
+  "version": "1.0.0",
+  "main": "lib/index.js",
+  "typings": "lib/index.d.ts",
+  "files": [
+    "lib"
+  ],
+  "license": "MIT",
+  "author": "johntime2005",
+  "scripts": {
+    "build": "tsc",
+    "prepublishOnly": "npm run build"
+  },
+  "peerDependencies": {
+    "koishi": "^4.17.9"
+  },
+  "devDependencies": {
+    "koishi": "^4.17.9",
+    "typescript": "^5.0.0"
+  },
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org"
+  },
+  "keywords": [
+    "koishi",
+    "plugin",
+    "minecraft",
+    "command",
+    "rcon",
+    "mc",
+    "game"
+  ],
+  "koishi": {
+    "description": {
+      "en": "Execute Minecraft server commands from chat platforms, works with minecraft-adapter",
+      "zh": "通过聊天平台执行 Minecraft 服务器命令，与 minecraft-adapter 联动"
+    }
+  }
+}