Back to mods
Pendulum project artwork

CurseForge · Minecraft mod

Pendulum

Client side script executor for Minecraft.

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Pendulum release should I use?

Updated 8 days ago
Latest stable file Pendulum 1.0 for 1.21.1 Fabric
Game version 1.21, 1.21.1
Loader Fabric

Pendulum 1.0 for 1.21.1 Fabric targets 1.21, 1.21.1 with Fabric. The project page does not say whether this file belongs on the client, dedicated server, or both. All 3 required mods have matching files.

Where it goes

Is Pendulum required on the client, server, or both?

The project page does not say whether this file belongs on the client, dedicated server, or both.

Client Source doesn’t say
Dedicated server Source doesn’t say
Loader for this release Fabric
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

The source does not explicitly classify this release as client-only or server-only.

What else does Pendulum 1.0 for 1.21.1 Fabric need?

Pendulum 1.0 for 1.21.1 Fabric. Change the file and its required mods may change too.

All 3 required mods have matching files

Install Jupiter, Rhino, Fabric API first. We found matching files for this game-version and loader setup. 4 come through another mod in the chain.

2 listed on this file 4 pulled in by those mods
Jupiter Needed by Pendulum 1.0 for 1.21.1 Fabric
required
Matching file found Matched file: Jupiter 2.3.7 for 1.21.1 Fabric
Rhino Needed by Pendulum 1.0 for 1.21.1 Fabric
required
Matching file found Matched file: Rhino 2101.2.7-build.85
Fabric API Needed by Jupiter
pulled in
Matching file found Matched file: [1.21.1] Fabric API 0.116.18+1.21.1
Forge Config API Port Needed by Jupiter
pulled in
Matching file found Matched file: [FABRIC] [1.21.1] ForgeConfigAPIPort-v21.1.6

4 extra mods were pulled in by other dependencies. Indented rows show who needs each one. We only count dependency files that match this setup. A file for another loader does not fill the gap.

Before you install it

Add Pendulum without breaking your instance.

Built for Pendulum 1.0 for 1.21.1 Fabric. Pick another file and the loader, install side or required mods may change.

  1. 01

    Stick to this file

    Use Pendulum 1.0 for 1.21.1 Fabric. It targets 1.21, 1.21.1 with Fabric; another release may have different loader, side or dependency requirements.

  2. 02

    Bring the mods it needs

    Install Jupiter, Rhino, Fabric API first. We found matching files for this game-version and loader setup. 4 come through another mod in the chain.

  3. 03

    Put it on the correct side

    The project page does not say whether this file belongs on the client, dedicated server, or both.

  4. 04

    Pick the file you checked

    Use the “Get this file” button beside Pendulum 1.0 for 1.21.1 Fabric. It opens that exact file at the source.

About this project

What does Pendulum add?

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: mc.player.forward(), mc.world.findBlocks(), mc.inv.hasItem(), mc.gui.click(), and more. Log via pendulum.log(), pendulum.warn(), pendulum.error().
  • br.* — 45 Baritone functions: pathfinding, mining, farming, building schematics

🤖 For AI Agents

  • MCP JSON-RPC 2.0 over TCP — native AI agent integration
  • script/eval — execute arbitrary JS and return results
  • script/status / script/abort — manage script state
  • gui/enumerateWidgets — full recursive widget tree
  • gui/guiElements — read all visible GUI controls
  • gui/screenshot — capture the game view
  • simulate/click / gui/clickButton — click GUI elements
  • simulate/typeText / simulate/pressKey — keyboard input
  • Compatible with VS Code Copilot, Claude Desktop, and any MCP client

Quick Start

// Walk forward 1 second
/pendulum execute mc.player.forward(20)

// Mine all pumpkins nearby
/pendulum execute for(let p of mc.world.findBlocks('minecraft:pumpkin',8)){ mc.player.breakBlockAt(p.x,p.y,p.z) }

// Run a script file
/pendulum file farm.js

// AI Agent workflow: screenshot + click
gui/screenshot  →  gui/clickButton("Done")  →  simulate/typeText("Hello", true)

MCP Server

Start the MCP server for AI agent access:

/pendulum mcp start      # default port 25566
/pendulum mcp stop       # stop the server
/pendulum mcp status     # check if running

Configure your MCP client to connect to localhost:25566 (default).

Project description from CurseForge.

Pick your setup

Pendulum by Minecraft version and loader

Choose the version and loader you play, then open the matching release.

8 available setups

Check the dependencies, then try the file in a copied instance before changing a world you care about.

Recent files

Pendulum versions and loaders

16 of 16 releases match

Looking for an older file? The official CurseForge project page is in Resources.