Installation

Installation

Requirements

• Minecraft Bedrock 1.21.100+
• Script API @minecraft/server 2.8.0 (stable; no Beta APIs experiment)
• The Recipe Registry host behavior pack enabled on the world (Host pack)
• mcbe-ipc in your pack (see Dependencies)

Option A — npm (recommended)

If you build your behavior pack with a bundler (esbuild, etc.):

npm install @mcbe-reciperegistry/client mcbe-ipc

Import the live helper:

import { createBedrockClient } from "@mcbe-reciperegistry/client/bedrock";

Your bundler must ship both this package and mcbe-ipc into the pack’s script. Bedrock does not read node_modules at runtime.

Option B — drop-in recipe-registry-client.js

If you copy scripts by hand:

1. Download recipe-registry-client.js from this repo’s Releases.
2. Put Omniac’s IPC build next to it as mcbe-ipc.js (see their install notes / rename their dist/ipc.js).
3. Import from your entry script:

import { createBedrockClient } from "./recipe-registry-client.js";

recipe-registry-client.js does not include Omniac’s code. Each pack needs its own mcbe-ipc.js.

Manifest dependency

In your behavior pack manifest.json, depend on the host pack UUID:

33303c67-a05d-4964-b2c3-ba7c42d8d3b6

Match the host’s version to the release the player installed (for host 0.2.1 that is [0, 2, 1]).

Bedrock will not download the host for you. The player imports it once from CurseForge.