CurseForge · Minecraft mod
Pendulum
Client side script executor for Minecraft.
Quick answer
Which Pendulum release matches 1.21 NeoForge?
Pendulum 1.0 for 1.21.1 Neoforge targets 1.21, 1.21.1 with NeoForge. The project page does not say whether this file belongs on the client, dedicated server, or both. All 2 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.
The source does not explicitly classify this release as client-only or server-only.
What else does Pendulum 1.0 for 1.21.1 Neoforge need?
Pendulum 1.0 for 1.21.1 Neoforge on 1.21 NeoForge. Every mod below is checked against that same setup.
Install Jupiter, Rhino first. We found matching files for this game-version and loader setup. 1 comes through another mod in the chain.
1 extra mod was pulled in by another dependency. 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 Neoforge on 1.21 NeoForge. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use Pendulum 1.0 for 1.21.1 Neoforge. It targets 1.21, 1.21.1 with NeoForge; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
Install Jupiter, Rhino first. We found matching files for this game-version and loader setup. 1 comes through another mod in the chain.
- 03
Put it on the correct side
The project page does not say whether this file belongs on the client, dedicated server, or both.
- 04
Pick the file you checked
Use the “Get this file” button beside Pendulum 1.0 for 1.21.1 Neoforge. 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.jsscripts from.minecraft/pendulum/mc.*— 80+ API functions:mc.player.forward(),mc.world.findBlocks(),mc.inv.hasItem(),mc.gui.click(), and more. Log viapendulum.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 resultsscript/status/script/abort— manage script stategui/enumerateWidgets— full recursive widget treegui/guiElements— read all visible GUI controlsgui/screenshot— capture the game viewsimulate/click/gui/clickButton— click GUI elementssimulate/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.
1.21.1
2 loader builds1.21
2 loader builds1.20.1
2 loader builds1.20
2 loader buildsCheck the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Pendulum versions and loaders
Pendulum 1.0 for 1.21.1 Neoforge
pendulum-1.0-1.21.1-neoforge.jar
15 Aug 2026
Pendulum 1.0-beta.3 for 1.21.1 Neoforge
pendulum-1.0-beta.3-1.21.1-neoforge.jar
5 Jun 2026
Pendulum 1.0-beta.2 for 1.21.1 Neoforge
pendulum-1.0-beta.2-1.21.1-neoforge.jar
3 Jun 2026
Pendulum 1.0-beta.1 for 1.21.1 Neoforge
pendulum-1.0-beta.1-1.21.1-neoforge.jar
2 Jun 2026
Looking for an older file? The official CurseForge project page is in Resources.