@mcbe-toolbox-lc/builder

Builder is a build tool that streamlines Minecraft Bedrock add-on development by letting you organize your pack files in a separate, isolated project directory instead of directly within the restrictive com.mojang folder.

Builder "compiles" your packs and copies the final output to the necessary com.mojang development folders so Minecraft can load them.

This workflow simplifies development, enables easy third-party tool integration, and allows for proper version control (with Git).

Prerequisites

• Node.js (v22 or later)

Usage

Run the following command in your project directory to install builder:

npm install @mcbe-toolbox-lc/builder --save-dev

Builder has no interface other than a public build() function that initiates a build operation based on the configuration object provided as an argument.

You have to create a JavaScript/TypeScript file that imports the function and calls it, then execute the file using the node command (or tsx for TypeScript).

import * as builder from "@mcbe-toolbox-lc/builder";

// Please look at intellisense and JSDoc for details.

await builder.build({
  behaviorPack: {
    srcDir: "src/bp",
    targetDir: "dist/bp",
  },
  resourcePack: {
    srcDir: "src/rp",
    targetDir: "dist/rp",
  },
  watch: true,
});