Skip to main content
The Minecraft Creator Tools CLI (mct) provides a powerful command-line interface for validating, creating, and managing Minecraft Bedrock Edition add-ons and projects.

Installation

Install the CLI globally using npm:
npm install -g @minecraft/creator-tools
Or run it directly with npx:
npx @minecraft/creator-tools [command]

Basic Usage

mct [command] [options]

Available Commands

validate

Validate Minecraft projects and add-ons

create

Create new Minecraft projects from templates

serve

Run a web server for validation and dedicated server management

deploy

Deploy projects to Minecraft installation folders

Global Options

These options are available for most commands:
-i, --input-folder
string
Path to the input folder. Defaults to current working directory.
-if, --input-file
string
Path to input MCWorld, MCTemplate, MCPack, MCAddon or other zip file.
-o, --output-folder
string
default:"out"
Path to the output folder.
--threads
number
default:"8"
Number of worker threads to use. Use 1 for sequential processing, >1 for parallel processing.
-lv, --log-verbose
boolean
Show verbose log messages.
-show, --display-only
boolean
Display messages only, without writing report files.
-f, --force
boolean
Force updates and overwrite existing files.

Quick Start Examples

Validate a project

mct validate -i ./my-addon -show

Create a new project

mct create

Deploy to Minecraft

mct deploy mcuwp -i ./my-addon

Exit Codes

The CLI uses specific exit codes to indicate different types of errors:
CodeDescription
0Success
44Initialization error
53Internal processing error during validation
56Test failure
57Validation error

Getting Help

Display help information for any command:
mct --help
mct [command] --help

Version Information

mct version
Displays version, installation paths, and configuration details.

Build docs developers (and LLMs) love