Skip to content

Minecraft MCP 0.5.0 — Persistent scripts and task control

Latest

Choose a tag to compare

@MakkCH MakkCH released this 18 Nov 14:04
a7dd356

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

  1. 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.
  2. If your connection uses MINECRAFT_MCP_PORT, replace it with MINECRAFT_MCP_URL and include the full address, for example http://127.0.0.1:28474/. The default is http://127.0.0.1:28473/. Keep your existing token.
  3. Update a separately installed Skill with npx skills update minecraft-mcp -g (use -p for 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