Repository navigation
Adds support for persistent scripts and singleplayer server callbacks. Running tasks now survive settings changes, and stopping an individual task leaves unrelated Baritone routes alone.
Upgrading
- Close Minecraft and replace the old mod JAR with the 0.5.0 build for your game version. Update the MCP server at the same time. If your client uses
@makkch/minecraft-mcp@latest, restart the MCP connection. For a pinned or local installation, update to 0.5.0 first. - If your connection uses
MINECRAFT_MCP_PORT, replace it withMINECRAFT_MCP_URLand include the full address, for examplehttp://127.0.0.1:28474/. The default ishttp://127.0.0.1:28473/. Keep your existing token. - Update a separately installed Skill with
npx skills update minecraft-mcp -g(use-pfor a project installation).
New features
- Scripts now close when they finish by default. Existing scripts that leave a map overlay or event listener active after returning need
keep_alive: true. - In singleplayer,
mcp.serverThread(fn)runs a callback on the integrated server thread and returns its result. - Screenshots are now returned as JPEG images.
- Claude Code users can install the Minecraft MCP plugin from the repository marketplace.
Fixes
- Applying settings in F8 preserves running tasks and their buffered output. If you change the port or token, reconnect with the new settings to read the remaining output.
- Stopping one task runs its registered cleanup. Scripts that relied on automatic Baritone cancellation can register their own stop action with
mcp.track.
Downloads and updating
Choose the client mod and dependencies for your Minecraft version.
| Minecraft | Client mod | JsMacros Reloaded (required) | Baritone API Fabric (optional) |
|---|---|---|---|
| 26.1 / 26.1.1 / 26.1.2 | minecraft-mcp-26.1-0.5.0.jar |
2.2.1 for 26.1 | 1.18.0 |
| 26.2 | minecraft-mcp-26.2-0.5.0.jar |
2.2.1 for 26.2 | 1.19.0 |
| 26.3 | minecraft-mcp-26.3-0.5.0.jar |
2.2.1 for 26.3 | 1.20.0 |
The shared agent package is available on npm or as minecraft-mcp-0.5.0.tgz under Assets. SHA256SUMS covers the three JARs and the archive. npm package
Requires Java 25+, Fabric Loader 0.19.5+ and the matching JsMacros Reloaded build. The agent package requires Node.js 22+.
Tested in game on Minecraft 26.3.
Installation instructions · Scripting reference · Full changes