Skip to content

v0.1.0

Choose a tag to compare

@chapmanjw chapmanjw released this 16 May 18:53
· 17 commits to main since this release

First release of the Bedrock Bridge behavior pack — the in-game half of the
minecraft-bedrock-mcp-server system.
It long-polls the bridge for commands, executes them through the Bedrock Script API, and reports
results and subscribed world events back.

Installation

Download bedrock-bridge.mcpack below — it is a ZIP of the pack folder (manifest.json,
scripts/main.js, pack_icon.png). Unzip it into your world's behavior_packs/ directory and
activate it via world_behavior_packs.json. See the README
for configuration, and the MCP server README
for the full end-to-end tutorial.

What's included

  • Bridge protocol 1.0.0 — handshake, command, result, and event envelopes.
  • Poll-loop state machine: handshake negotiation, continuous long-polling, and reconnection with
    jittered backoff that re-handshakes on a lost session.
  • The full 71-handler command surface — world, blocks, structures, entities, players,
    inventory, scoreboard, dynamic properties, effects, event subscriptions, the raw-command escape
    hatch, and server administration.
  • On-demand Script API event subscriptions, batched to the bridge with size/time flushing.

Requirements

  • A Minecraft Bedrock Dedicated Server, 1.21.0 or newer.
  • A world with the Beta APIs experiment enabled.
  • The companion minecraft-bedrock-mcp-server, running on the same host.

⚠️ Built on an experimental API

This pack depends on Mojang's Bedrock Script API, including the beta modules
@minecraft/server-net and @minecraft/server-admin. A Bedrock update can change, deprecate, or
remove APIs this pack depends on. Pin your BDS to a known-good version.