Pendulum

Pendulum

Minecraft 客户端 JavaScript 执行器。 自动化玩家操作——移动、建造、战斗、物品栏、世界查询，并支持 Baritone。专为人类玩家和 AI 智能体设计。

此模组部分灵感来源于 Playwright.js，后者允许智能体通过 JavaScript 控制网页浏览器。Pendulum 将同样的能力带入 Minecraft，通过简单的 JS API 实现复杂的自动化与 AI 集成。

版本支持

Minecraft	Fabric	Forge	NeoForge	状态
1.20.1	✅	✅		完整支持
1.21.1	✅	❌	✅	完整支持
26.1.2	🔨	❌	🔨	开发中

特性

详细文档请参阅 文档

🧑 为玩家准备

• /pendulum execute —— 在聊天中内联运行 JavaScript
• /pendulum file —— 运行位于 .minecraft/pendulum/ 目录下的 .js 脚本
• mc.* —— 80 多个 API 函数：mc.player.forward()、mc.world.findBlocks()、mc.inv.hasItem()、mc.gui.click() 等。可通过 pendulum.log()、pendulum.warn()、pendulum.error() 记录日志。
• br.* —— 45 个 Baritone 函数：寻路、挖矿、耕作、建造建筑图纸

🤖 为 AI 智能体准备

• 基于 TCP 的 MCP JSON-RPC 2.0 —— 原生 AI 智能体集成
• script/eval —— 执行任意 JS 并返回结果
• script/status / script/abort —— 管理脚本状态
• gui/enumerateWidgets —— 完整的递归控件树
• gui/guiElements —— 读取所有可见的 GUI 控件
• gui/screenshot —— 捕获游戏画面
• simulate/click / gui/clickButton —— 点击 GUI 元素
• simulate/typeText / simulate/pressKey —— 键盘输入
• 兼容 VS Code Copilot、Claude Desktop 及任意 MCP 客户端

快速开始

// 向前行走 1 秒
/pendulum execute mc.player.forward(20)

// 挖掘附近所有的南瓜
/pendulum execute for(let p of mc.world.findBlocks('minecraft:pumpkin',8)){ mc.player.breakBlockAt(p.x,p.y,p.z) }

// 运行一个脚本文件
/pendulum file farm.js

// AI 智能体工作流：截图 + 点击
gui/screenshot  →  gui/clickButton("完成")  →  simulate/typeText("你好", true)

MCP 服务器

启动 MCP 服务器以供 AI 智能体访问：

/pendulum mcp start      # 默认端口 25566
/pendulum mcp stop       # 停止服务器
/pendulum mcp status     # 检查是否在运行

配置你的 MCP 客户端连接至 localhost:25566（默认）。