@mcbe-mods/create

CLI tool for scaffolding and developing Minecraft Bedrock Edition addons.

Install

npm install -g @mcbe-mods/create

Usage

Create a new project

mcbe-create init my-addon

Interactive prompts guide you through:

• Project type (packs + script API combined)
• Script language (TypeScript or JavaScript)
• Package manager (npm, pnpm, yarn)

Use --yes to skip all prompts and create with defaults:

mcbe-create init my-addon --yes

Use short flags to customize non-interactively:

mcbe-create init my-addon -a "Author" -d "My addon" -l js --no-scripts -k bp -y
mcbe-create init my-addon -v 1.20.0 -p pnpm --no-install

Run init inside an existing project to add missing packs.

Development

cd my-addon
mcbe-create dev            # Watch source files and rebuild
mcbe-create dev --sync     # Also sync changes to Minecraft dev packs

• Mirrors pack files from src/ to dist/
• Compiles TypeScript on change (when using TS)
• --sync automatically copies dist/ to Minecraft development pack directories

Build & package

mcbe-create build

Produces a .mcaddon file in the pack/ directory.

Other commands

mcbe-create sync      # Manual one-shot sync dist/ to Minecraft
mcbe-create manifest  # Patch manifest.json from project config
mcbe-create info      # Show project information

Options

init

| Argument / Option | Type | Default | Description | |-------------------|------|---------|-------------| | [project-name] | string | — | Project name (prompted if omitted) | | -y, --yes | boolean | false | Skip all prompts, use defaults for unspecified fields | | -a, --author <author> | string | '' | Author name | | -d, --desc <desc> | string | '' | Project description | | -l, --lang <lang> | string | 'typescript' | Script language (typescript, javascript) | | -v, --mc-version <version> | string | '1.18.0' | @minecraft/server version | | -p, --pm <pm> | string | auto-detected | Package manager (npm, pnpm, yarn) | | -k, --packs <packs> | string | 'bp,rp' | Packs to include (bp, rp, comma-separated) | | --no-scripts | boolean | — | Disable Minecraft Script API | | --no-install | boolean | — | Skip dependency installation | | --add-bp | boolean | — | Add behavior pack to existing project | | --add-rp | boolean | — | Add resource pack to existing project |

dev

| Option | Description | |--------|-------------| | --sync | Also sync changes to Minecraft development pack directories |

License

MIT License © 2026-Present Lete114

Project structure

my-addon/
├── src/
│   ├── behavior_pack/          # Behavior Pack (user choice)
│   │   ├── manifest.json       # Editable by user
│   │   ├── scripts/main.ts     # Only with Script API (.ts or .js depending on language)
│   │   └── texts/
│   └── resource_pack/          # Resource Pack (user choice)
│       ├── manifest.json
│       └── texts/
├── dist/                       # Built output
│   ├── behavior_pack/
│   └── resource_pack/
├── pack/                       # .mcaddon output
├── package.json                # Contains "mcbe" field for configuration
└── tsconfig.json               # Only for TypeScript projects

Requirements

• Node.js >= 20.19.0
• Minecraft Bedrock Edition (Windows)