Pendulum

Client-side JavaScript executor for Minecraft. Automate player actions — movement, construction, combat, inventory, world queries, and Baritone supported. Designed for both human players and AI agents.

This mod is partly inspired by Playwright.js, which allows agents to control web browsers via JavaScript. Pendulum brings that same power to Minecraft, enabling complex automation and AI integration through a simple JS API.

Version Support

Minecraft Fabric Forge NeoForge Status 1.20.1 ✅ ✅ Fully Supported 1.21.1 ✅ ❌ ✅ Fully Supported 26.1.2 🔨 ❌ 🔨 In development

Features

For detailed documentation, see the Documentation

🧑 For Players

/pendulum execute — run JavaScript inline in chat
/pendulum file — run .js scripts from .minecraft/pendulum/
mc.* — 80+ API functions: move, mine, build, craft, query the world
br.* — 45 Baritone functions: pathfinding, mining, farming, building schematics

🤖 For AI Agents

MCP JSON-RPC 2.0 over TCP — native AI agent integration
pendulum_eval — execute arbitrary JS and return results
pendulum_screenshot — capture the game view
pendulum_gui_elements — read all visible GUI controls
pendulum_status / pendulum_abort — manage script state
Compatible with VS Code Copilot, Claude Desktop, and any MCP client

Quick Start

// Walk forward 1 second /pendulum execute mc.forward(20) // Mine all pumpkins nearby /pendulum execute for(let p of mc.findBlocks('minecraft:pumpkin',8)){ mc.breakBlockAt(p.x,p.y,p.z) } // Run a script file /pendulum file farm.js