@kzheart_/mc-pilot 0.9.1 → 0.9.3

package/data/protocol/actions.json

@@ -0,0 +1,231 @@
+{
+  "schemaVersion": 1,
+  "requestFormat": {
+    "id": "uuid-v4",
+    "action": "string",
+    "params": "object"
+  },
+  "responseFormat": {
+    "id": "uuid-v4",
+    "success": "boolean",
+    "data": "object|null",
+    "error": "object|null"
+  },
+  "actions": [
+    {
+      "name": "chat.send",
+      "params": ["message"],
+      "description": "发送聊天消息"
+    },
+    {
+      "name": "chat.command",
+      "params": ["command"],
+      "description": "执行聊天命令"
+    },
+    {
+      "name": "chat.wait",
+      "params": ["match", "timeout"],
+      "description": "等待匹配的聊天消息"
+    },
+    {
+      "name": "move.to",
+      "params": ["x", "y", "z"],
+      "description": "寻路移动到指定坐标"
+    },
+    {
+      "name": "move.direction",
+      "params": ["direction", "blocks"],
+      "description": "朝指定方向移动"
+    },
+    {
+      "name": "move.jump",
+      "params": [],
+      "description": "跳跃一次"
+    },
+    {
+      "name": "move.sneak",
+      "params": ["enabled"],
+      "description": "切换潜行"
+    },
+    {
+      "name": "move.sprint",
+      "params": ["enabled"],
+      "description": "切换疾跑"
+    },
+    {
+      "name": "look.at",
+      "params": ["x", "y", "z"],
+      "description": "看向坐标"
+    },
+    {
+      "name": "look.entity",
+      "params": ["filter"],
+      "description": "看向实体"
+    },
+    {
+      "name": "look.set",
+      "params": ["yaw", "pitch"],
+      "description": "设置精确视角"
+    },
+    {
+      "name": "block.break",
+      "params": ["x", "y", "z"],
+      "description": "破坏方块"
+    },
+    {
+      "name": "block.place",
+      "params": ["x", "y", "z", "face"],
+      "description": "放置方块"
+    },
+    {
+      "name": "block.interact",
+      "params": ["x", "y", "z"],
+      "description": "右键交互方块"
+    },
+    {
+      "name": "entity.attack",
+      "params": ["filter"],
+      "description": "攻击实体"
+    },
+    {
+      "name": "entity.interact",
+      "params": ["filter"],
+      "description": "右键交互实体"
+    },
+    {
+      "name": "entity.mount",
+      "params": ["filter"],
+      "description": "骑乘实体"
+    },
+    {
+      "name": "entity.dismount",
+      "params": [],
+      "description": "离开载具"
+    },
+    {
+      "name": "entity.steer",
+      "params": ["forward", "sideways", "jump", "sneak"],
+      "description": "控制载具"
+    },
+    {
+      "name": "inventory.hotbar",
+      "params": ["slot"],
+      "description": "切换快捷栏"
+    },
+    {
+      "name": "inventory.drop",
+      "params": ["all"],
+      "description": "丢弃手持物品"
+    },
+    {
+      "name": "inventory.use",
+      "params": [],
+      "description": "使用手持物品"
+    },
+    {
+      "name": "inventory.swap-hands",
+      "params": [],
+      "description": "交换主副手"
+    },
+    {
+      "name": "gui.click",
+      "params": ["slot", "button", "key"],
+      "description": "点击 GUI 槽位"
+    },
+    {
+      "name": "gui.drag",
+      "params": ["slots", "button"],
+      "description": "拖拽 GUI 槽位"
+    },
+    {
+      "name": "gui.close",
+      "params": [],
+      "description": "关闭 GUI"
+    },
+    {
+      "name": "gui.wait-open",
+      "params": ["timeout"],
+      "description": "等待 GUI 打开"
+    },
+    {
+      "name": "gui.wait-update",
+      "params": ["timeout"],
+      "description": "等待 GUI 更新"
+    },
+    {
+      "name": "gui.screenshot",
+      "params": ["output"],
+      "description": "GUI 截图"
+    },
+    {
+      "name": "capture.screenshot",
+      "params": ["output", "region", "gui"],
+      "description": "屏幕截图"
+    },
+    {
+      "name": "sign.edit",
+      "params": ["x", "y", "z", "lines"],
+      "description": "编辑告示牌"
+    },
+    {
+      "name": "book.write",
+      "params": ["pages"],
+      "description": "写入书本"
+    },
+    {
+      "name": "book.sign",
+      "params": ["title", "author"],
+      "description": "签名书本"
+    },
+    {
+      "name": "channel.send",
+      "params": ["channel", "data"],
+      "description": "发送 Plugin Channel 消息"
+    },
+    {
+      "name": "channel.listen",
+      "params": ["channel", "timeout"],
+      "description": "等待 Plugin Channel 消息"
+    },
+    {
+      "name": "resourcepack.accept",
+      "params": [],
+      "description": "接受资源包"
+    },
+    {
+      "name": "resourcepack.reject",
+      "params": [],
+      "description": "拒绝资源包"
+    },
+    {
+      "name": "craft.craft",
+      "params": ["recipe"],
+      "description": "工作台合成"
+    },
+    {
+      "name": "craft.anvil",
+      "params": ["inputSlot", "rename"],
+      "description": "铁砧操作"
+    },
+    {
+      "name": "craft.enchant",
+      "params": ["option"],
+      "description": "附魔台操作"
+    },
+    {
+      "name": "craft.trade",
+      "params": ["index"],
+      "description": "交易操作"
+    },
+    {
+      "name": "wait.perform",
+      "params": ["seconds", "ticks", "untilHealthAbove", "untilGuiOpen", "untilOnGround", "timeout"],
+      "description": "等待与同步"
+    },
+    {
+      "name": "client.reconnect",
+      "params": ["address"],
+      "description": "让客户端重新连接到指定服务器地址"
+    }
+  ]
+}

package/data/protocol/errors.json

@@ -0,0 +1,80 @@
+{
+  "schemaVersion": 1,
+  "errors": [
+    {
+      "code": "CONNECTION_FAILED",
+      "exitCode": 1,
+      "description": "无法连接到客户端 WebSocket"
+    },
+    {
+      "code": "TIMEOUT",
+      "exitCode": 2,
+      "description": "操作等待超时"
+    },
+    {
+      "code": "CLIENT_NOT_FOUND",
+      "exitCode": 3,
+      "description": "找不到客户端"
+    },
+    {
+      "code": "CLIENT_NOT_RUNNING",
+      "exitCode": 3,
+      "description": "客户端未运行"
+    },
+    {
+      "code": "CLIENT_ALREADY_RUNNING",
+      "exitCode": 3,
+      "description": "客户端已在运行"
+    },
+    {
+      "code": "INVALID_PARAMS",
+      "exitCode": 4,
+      "description": "参数格式错误或缺少必要配置"
+    },
+    {
+      "code": "SERVER_NOT_RUNNING",
+      "exitCode": 5,
+      "description": "服务端未运行"
+    },
+    {
+      "code": "SERVER_ALREADY_RUNNING",
+      "exitCode": 5,
+      "description": "服务端已在运行"
+    },
+    {
+      "code": "GUI_NOT_OPEN",
+      "exitCode": 3,
+      "description": "没有打开的 GUI"
+    },
+    {
+      "code": "SLOT_OUT_OF_RANGE",
+      "exitCode": 3,
+      "description": "槽位索引超出范围"
+    },
+    {
+      "code": "ENTITY_NOT_FOUND",
+      "exitCode": 3,
+      "description": "找不到匹配实体"
+    },
+    {
+      "code": "BLOCK_OUT_OF_RANGE",
+      "exitCode": 3,
+      "description": "目标方块超出交互距离"
+    },
+    {
+      "code": "PATHFINDING_FAILED",
+      "exitCode": 3,
+      "description": "寻路失败"
+    },
+    {
+      "code": "NOT_IN_WORLD",
+      "exitCode": 3,
+      "description": "玩家不在世界中"
+    },
+    {
+      "code": "INTERNAL_ERROR",
+      "exitCode": 1,
+      "description": "CLI 内部错误"
+    }
+  ]
+}

package/data/protocol/queries.json

@@ -0,0 +1,160 @@
+{
+  "schemaVersion": 1,
+  "queries": [
+    {
+      "name": "chat.history",
+      "params": ["last"],
+      "description": "获取聊天历史"
+    },
+    {
+      "name": "chat.last",
+      "params": [],
+      "description": "获取最后一条聊天消息"
+    },
+    {
+      "name": "position.get",
+      "params": [],
+      "description": "获取当前位置"
+    },
+    {
+      "name": "rotation.get",
+      "params": [],
+      "description": "获取当前朝向"
+    },
+    {
+      "name": "block.get",
+      "params": ["x", "y", "z"],
+      "description": "查询方块信息"
+    },
+    {
+      "name": "entity.list",
+      "params": ["radius"],
+      "description": "列出范围内实体"
+    },
+    {
+      "name": "entity.info",
+      "params": ["id"],
+      "description": "查询实体详情"
+    },
+    {
+      "name": "inventory.get",
+      "params": [],
+      "description": "获取完整背包"
+    },
+    {
+      "name": "inventory.slot",
+      "params": ["slot"],
+      "description": "获取指定槽位"
+    },
+    {
+      "name": "inventory.held",
+      "params": [],
+      "description": "获取当前手持物品"
+    },
+    {
+      "name": "gui.info",
+      "params": [],
+      "description": "获取 GUI 信息"
+    },
+    {
+      "name": "gui.snapshot",
+      "params": [],
+      "description": "获取 GUI 快照"
+    },
+    {
+      "name": "gui.slot",
+      "params": ["slot"],
+      "description": "获取 GUI 槽位"
+    },
+    {
+      "name": "screen.size",
+      "params": [],
+      "description": "获取屏幕大小"
+    },
+    {
+      "name": "hud.scoreboard",
+      "params": [],
+      "description": "获取侧边栏计分板"
+    },
+    {
+      "name": "hud.tab",
+      "params": [],
+      "description": "获取 Tab 列表"
+    },
+    {
+      "name": "hud.bossbar",
+      "params": [],
+      "description": "获取 BossBar"
+    },
+    {
+      "name": "hud.actionbar",
+      "params": [],
+      "description": "获取 ActionBar"
+    },
+    {
+      "name": "hud.title",
+      "params": [],
+      "description": "获取 Title"
+    },
+    {
+      "name": "hud.nametag",
+      "params": ["player"],
+      "description": "获取指定玩家名牌"
+    },
+    {
+      "name": "status.health",
+      "params": [],
+      "description": "获取生命与饥饿状态"
+    },
+    {
+      "name": "status.effects",
+      "params": [],
+      "description": "获取药水效果"
+    },
+    {
+      "name": "status.experience",
+      "params": [],
+      "description": "获取经验状态"
+    },
+    {
+      "name": "status.gamemode",
+      "params": [],
+      "description": "获取游戏模式"
+    },
+    {
+      "name": "status.world",
+      "params": [],
+      "description": "获取世界状态"
+    },
+    {
+      "name": "status.all",
+      "params": [],
+      "description": "获取聚合状态"
+    },
+    {
+      "name": "sign.read",
+      "params": ["x", "y", "z"],
+      "description": "读取告示牌"
+    },
+    {
+      "name": "book.read",
+      "params": [],
+      "description": "读取书本"
+    },
+    {
+      "name": "resourcepack.status",
+      "params": [],
+      "description": "获取资源包状态"
+    },
+    {
+      "name": "effects.sounds",
+      "params": ["last"],
+      "description": "获取最近音效事件"
+    },
+    {
+      "name": "effects.particles",
+      "params": ["last"],
+      "description": "获取最近粒子事件"
+    }
+  ]
+}

package/data/variants.json

@@ -31,11 +31,12 @@
       "id": "1.20.1-forge",
       "minecraftVersion": "1.20.1",
       "loader": "forge",
-      "support": "planned",
-      "validation": "planned",
+      "support": "configured",
+      "validation": "limited",
       "modVersion": "0.9.1",
       "forgeVersion": "47.3.0",
-      "javaVersion": 17
+      "javaVersion": 17,
+      "gradleModule": "version-1.20.1-forge"
     },
     {
       "id": "1.20.2-fabric",
@@ -53,11 +54,12 @@
       "id": "1.20.2-forge",
       "minecraftVersion": "1.20.2",
       "loader": "forge",
-      "support": "planned",
-      "validation": "planned",
+      "support": "configured",
+      "validation": "limited",
       "modVersion": "0.9.1",
       "forgeVersion": "48.1.0",
-      "javaVersion": 17
+      "javaVersion": 17,
+      "gradleModule": "version-1.20.2-forge"
     },
     {
       "id": "1.20.4-fabric",
@@ -75,11 +77,12 @@
       "id": "1.20.4-forge",
       "minecraftVersion": "1.20.4",
       "loader": "forge",
-      "support": "planned",
-      "validation": "planned",
+      "support": "configured",
+      "validation": "limited",
       "modVersion": "0.9.1",
       "forgeVersion": "49.0.49",
-      "javaVersion": 17
+      "javaVersion": 17,
+      "gradleModule": "version-1.20.4-forge"
     },
     {
       "id": "1.20.4-neoforge",

package/dist/commands/client.js

@@ -5,14 +5,8 @@ import { ServerInstanceManager } from "../instance/ServerInstanceManager.js";
 import { MctError } from "../util/errors.js";
 import { createRequestAction } from "./request-helpers.js";
 import { wrapCommand } from "../util/command.js";
-import { CacheManager } from "../download/CacheManager.js";
-import { findVariantByVersionAndLoader, getModArtifactFileName, loadModVariantCatalog } from "../download/ModVariantCatalog.js";
-import { detectJava } from "../download/JavaDetector.js";
-import { prepareManagedFabricRuntime } from "../download/client/FabricRuntimeDownloader.js";
-import { copyFileIfMissing, downloadFile } from "../download/DownloadUtils.js";
+import { downloadClientModToDir } from "../download/client/ClientDownloader.js";
 import { resolveClientInstanceDir } from "../util/paths.js";
-import { access, mkdir } from "node:fs/promises";
-import path from "node:path";
 export async function resolveProfileServerAddress(context, explicitServer, loadPort) {
     if (explicitServer) {
         return explicitServer;
@@ -50,93 +44,46 @@ export function createClientCommand() {
         .description("Create a new client instance")
         .argument("<name>", "Client instance name (e.g. fabric-1.20.4)")
         .option("--version <version>", "Minecraft version (default: 1.21.4)")
-        .option("--loader <loader>", "Client loader: fabric (default: fabric)")
+        .option("--loader <loader>", "Client loader: fabric|forge (default: fabric)")
         .option("--ws-port <port>", "WebSocket port (auto-assigned if omitted)", Number)
         .option("--account <account>", "Offline username or account identifier")
         .option("--headless", "Launch in headless mode")
+        .option("--mute", "Mute all in-game audio for this client")
+        .option("--no-mute", "Keep in-game audio enabled for this client")
         .option("--java <command>", "Java command to use")
         .action(wrapCommand(async (_context, { args, options }) => {
         const clientName = args[0];
         const loader = options.loader ?? "fabric";
         const version = options.version ?? "1.21.4";
-        const cacheManager = new CacheManager();
-        const catalog = await loadModVariantCatalog();
-        const variant = findVariantByVersionAndLoader(catalog, version, loader);
-        if (!variant) {
-            throw new MctError({ code: "VARIANT_NOT_FOUND", message: `No mod variant found for ${version} / ${loader}` }, 4);
-        }
-        if (variant.loader !== "fabric") {
-            throw new MctError({ code: "UNSUPPORTED_LOADER", message: `Loader ${variant.loader} is not implemented yet` }, 4);
-        }
-        // Check Java
-        const java = await detectJava(options.java ?? "java");
-        const requiredJava = variant.javaVersion ?? 17;
-        if (!java.available || (java.majorVersion ?? 0) < requiredJava) {
-            throw new MctError({ code: "JAVA_NOT_FOUND", message: `Java ${requiredJava}+ is required for ${variant.id}` }, 4);
-        }
-        // Resolve mod artifact
-        const artifactFileName = getModArtifactFileName(variant);
-        const cacheArtifactPath = cacheManager.getModFile(artifactFileName);
-        const gradleModule = variant.gradleModule ?? `version-${variant.minecraftVersion}`;
-        const localBuildPath = path.join(process.cwd(), "client-mod", gradleModule, "build", "libs", artifactFileName);
-        let sourcePath;
-        try {
-            await access(localBuildPath);
-            sourcePath = localBuildPath;
-            await copyFileIfMissing(localBuildPath, cacheArtifactPath);
-        }
-        catch {
-            try {
-                await access(cacheArtifactPath);
-                sourcePath = cacheArtifactPath;
-            }
-            catch {
-                const modVersion = variant.modVersion ?? "0.9.1";
-                const baseUrl = process.env.MCT_MOD_DOWNLOAD_BASE_URL || "https://github.com/kzheart/mc-pilot/releases/download";
-                const downloadUrl = `${baseUrl}/v${modVersion}/${artifactFileName}`;
-                await downloadFile(downloadUrl, cacheArtifactPath, fetch);
-                sourcePath = cacheArtifactPath;
-            }
-        }
-        // Set up client instance directory
         const instanceDir = resolveClientInstanceDir(clientName);
-        const minecraftDir = path.join(instanceDir, "minecraft");
-        const modsDir = path.join(minecraftDir, "mods");
-        await mkdir(modsDir, { recursive: true });
-        await copyFileIfMissing(sourcePath, path.join(modsDir, artifactFileName));
-        // Prepare Fabric runtime
-        const runtimeRootDir = path.join(cacheManager.getRootDir(), "client", "runtime", variant.minecraftVersion);
-        const managedRuntime = await prepareManagedFabricRuntime(variant, {
-            runtimeRootDir,
-            gameDir: minecraftDir
-        }, { fetchImpl: fetch });
-        const launchArgs = [
-            "--runtime-root", managedRuntime.runtimeRootDir,
-            "--version-id", managedRuntime.versionId,
-            "--game-dir", managedRuntime.gameDir
-        ];
+        const downloaded = await downloadClientModToDir(process.cwd(), instanceDir, {
+            version,
+            loader,
+            java: options.java
+        });
         const manager = new ClientInstanceManager(_context.globalState);
         const meta = await manager.create({
             name: clientName,
-            loader,
-            version: variant.minecraftVersion,
+            loader: downloaded.loader,
+            version: downloaded.minecraftVersion,
             wsPort: options.wsPort,
             account: options.account,
             headless: options.headless,
-            launchArgs,
+            mute: options.mute,
+            launchArgs: downloaded.launchArgs,
             env: {
-                MCT_CLIENT_MOD_VARIANT: variant.id,
-                MCT_CLIENT_MOD_JAR: path.join(modsDir, artifactFileName)
+                MCT_CLIENT_MOD_VARIANT: downloaded.variantId,
+                MCT_CLIENT_MOD_JAR: downloaded.jar
             }
         });
         return {
             created: true,
             ...meta,
-            javaCommand: java.command,
-            javaVersion: java.majorVersion,
-            modsDir,
-            runtimeRootDir: managedRuntime.runtimeRootDir,
-            runtimeVersionId: managedRuntime.versionId
+            javaCommand: downloaded.javaCommand,
+            javaVersion: downloaded.javaVersion,
+            modsDir: downloaded.modsDir,
+            runtimeRootDir: downloaded.runtimeRootDir,
+            runtimeVersionId: downloaded.runtimeVersionId
         };
     }));
     command
@@ -147,6 +94,8 @@ export function createClientCommand() {
         .option("--account <account>", "Offline username or account identifier")
         .option("--ws-port <port>", "WebSocket port override", Number)
         .option("--headless", "Launch in headless mode")
+        .option("--mute", "Mute all in-game audio for this launch")
+        .option("--no-mute", "Keep in-game audio enabled for this launch")
         .option("--force", "Kill any existing client with the same name before launching")
         .action(wrapCommand(async (context, { args, options }) => {
         const clientName = args[0] ?? context.activeProfile?.clients[0];

package/dist/commands/image.d.ts

@@ -0,0 +1,2 @@
+import { Command } from "commander";
+export declare function createImageCommand(): Command;