Skip to main content
@bedrock-core
betaMIT

Addons Better Connected

Addons run in isolated realms. @bedrock-core lets yours find each other, work together, and draw custom UI the whole world can use.

npx @bedrock-core/cli
  • Type-safe by design
  • Built for Vanilla Bedrock

Packages

One scope, four categories.

Install the meta-package for a matching set, or take the layers you need on their own.

What you get

Cross-realm plumbing, already solved.

Six pieces that turn a pile of unrelated behavior packs into one coordinated world.

Runtime discovery

Register once. Every other bedrock-core addon in the world sees you, and you see them, the moment they load.

Typed addon APIs

Import async functions and observable values from addon packages while their implementation runs in the owning addon.

Shared state

A declared shape every realm mirrors locally as a typed tree. Reads are synchronous, writes broadcast a delta.

JSX screens

React-like components for forms and containers. Screens compile ahead of time; only state moves at runtime.

Config, guides and translations

Declare a settings schema, ship an MDX guide and a typed translation bundle; the shared UI renders all three for every addon in the world.

One build chain

Builder compiles guides, localization and screens and bundles scripts. BDS runner executes GameTests on a dedicated server.

In practice

Two addons, one typed API.

Export an API from one addon, import it in another, and show the result in a compiled screen.

  1. 01
  2. 02
  3. 03
Read the walkthrough

Economy exports this module and its manifest through package.json. registerModule publishes the checked API from its owning behavior pack.

import { core, registerModule } from '@bedrock-core/server';
import manifest from '../manifest.json';

const balances = new Map<string, number>();

export const API = {
async getBalance(playerId: string): Promise<number> {
return balances.get(playerId) ?? 100;
},
};

core.register({ manifest, economy: registerModule(API) });

Start with one package.

Pin an exact version, and read the changelog before you upgrade.