MCBE

A TypeScript and JavaScript npm package to help Minecraft Bedrock Edition addon creators build blocks, items, entities, recipes, and scripts quickly, safely, and with full type support.

Features

• Fluent, type-safe API for creating blocks, items, entities, and recipes.
• Automatic validation of all data using Zod schemas.
• Generates all required JSON files for behavior and resource packs.
• Custom scripts for advanced logic and events.
• Extremely fast build (usually less than 0.5~ seconds for dozens of files).

Installation

npm i mcbe

Example

const { Block, Sword, Addon } = require("mcbe");

const xdBlock = new Block("mc:xd")
  .setComponent("minecraft:display_name", "Hello")
  .setComponent("minecraft:pushable", false)
  .setComponent("minecraft:breathability", "solid")
  .setComponent("minecraft:tick", { interval_range: [10, 10] })
  .onPlace((arg) => {
    console.warn("Hello");
  })
  .onTick((a) => {
    a.dimension;
  });

const helloSword = new Sword("mc:hello").setDamage(100);

new Addon({
  name: "Addon Template",
  description: "By Me",
})
  .addBlocks([xdBlock.toJSON()])
  .addItems([helloSword.toJSON()]);

What does it generate?

• JSON files for behavior_packs and resource_packs
• TypeScript scripts for custom logic
• Ready-to-import folder structure for Minecraft

Autocomplete

Enjoy full autocomplete and type safety in your editor:

📚 See more examples by clicking here

Made with ❤️