Minecraft Creator Tools

Copyright (c) 2026 Mojang AB. Licensed under the MIT License.

• License
• GitHub
• Report an Issue
• Changelog

This code is currently in pre-release alpha state.

See the public docs at https://learn.microsoft.com/minecraft/creator/documents/mctoolsoverview for more.

Getting Started

Requires Node.js 22+ and npm 10+.

npx mct

Displays default information and available commands.

Use --help with any command for detailed usage, or --all-commands to see internal/advanced commands.

Commands

Validation

| Command | Aliases | Description | | ------------------ | ------- | ----------------------------------------------------------------------------------------------------------------------------- | | validate | val | Validate a Minecraft project against a suite of rules. Supports suites: all, default, addon, currentplatform, main. | | search | s | Search a content index for matching items by term or annotation category. | | aggregatereports | aggr | Aggregate exported metadata across multiple projects. Optionally builds a content index. |

npx mct validate -i d:\mycontent\myprojectfolder
npx mct validate addon -i d:\mycontent\myprojectfolder -v

Project

| Command | Aliases | Description | | ------------- | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------- | | create | c | Create a new Minecraft project from a template. Prompts interactively for name, template, creator, and description. | | add | a | Add new content to an existing project (entity, block, item, spawnLootRecipes, worldGen, visuals, singleFiles). | | fix | — | Apply automated fixes: latestbetascriptversion, randomizealluids, setnewestformatversions, setnewestminengineversion. | | set | — | Set a project property (name, title, description, bpscriptentrypoint, bpuuid, rpuuid). | | info | i | Display information about the current project. | | setup | — | Ensure project configuration files are up to date and healthy. | | deploy | dp | Copy project files to a destination: mcuwp (Bedrock), mcpreview (Preview), server, or a custom path. Supports --test-world and --launch. | | exportaddon | — | Package the project into an .mcaddon file. | | exportworld | — | Export a flat GameTest .mcworld file for the project's behavior packs. |

npx mct create
npx mct add entity -i d:\mycontent\myprojectfolder
npx mct fix latestbetascriptversion -i d:\mycontent\myprojectfolder
npx mct deploy mcuwp -i d:\mycontent\myprojectfolder --test-world --launch
npx mct exportaddon -i d:\mycontent\myprojectfolder -o d:\output

Content Viewing & Editing

| Command | Aliases | Description | | ------- | ------- | ------------------------------------------------------------------------------------------------------------------------------- | | view | — | Open a read-only web browser UI to inspect Minecraft content with 3D previews, component inspector, and more. | | edit | — | Open a read-write web browser UI to edit Minecraft content with visual editors at three experience levels (Focused, Full, Raw). |

npx mct view -i d:\mycontent\myprojectfolder
npx mct edit -i d:\mycontent\myprojectfolder

Server

| Command | Aliases | Description | | ---------------------------------- | ------------------ | --------------------------------------------------------------------------------------------------------------------------------------------- | | serve | server | Start a web server with optional Bedrock Dedicated Server integration. Features include a map renderer, command tools, and player management. | | mcp | — | Run as a local MCP (Model Context Protocol) server for AI tool integration. | | dedicatedserve | bds, dedicated | Start only the Bedrock Dedicated Server without the web UI. | | passcodes | pc | Display active passcodes for web server authentication. | | setserverprops | serverprops | Display or set server properties (--domain, --port, --title, --motd). | | minecrafteulaandprivacystatement | eula | View and accept the Minecraft End User License Agreement. |

npx mct serve --adminpc mypassword --port 6126
npx mct serve --source-server-path "C:\BDS" --adminpc mypassword
npx mct mcp -i d:\mycontent\myprojectfolder
npx mct setserverprops --domain 10.0.0.6 --port 80

Render

| Command | Aliases | Description | | ----------------- | ----------------------- | ----------------------------------------------------------------------------------------------------------------------------- | | rendermodel | rm | Render a model geometry file (.geo.json) from the project to a PNG image. | | rendervanilla | rv | Render vanilla Minecraft blocks, mobs, or items to PNG images. Supports batch via comma-separated identifiers or @filename. | | renderstructure | renstruct, renderst | Render an .mcstructure file to a PNG image. | | buildstructure | buildstruct | Build an .mcstructure file from IBlockVolume JSON. Supports stdin input with -. |

npx mct rendervanilla mob minecraft:creeper -o creeper.png
npx mct rendervanilla block minecraft:stone,minecraft:dirt -o blocks/
npx mct rendermodel mymodel.geo.json -i d:\mycontent\myprojectfolder
npx mct buildstructure input.json output.mcstructure --preview preview.png

World

| Command | Aliases | Description | | ----------------- | ------------ | ----------------------------------------------------------------------------------------------- | | world | — | Display or modify world settings (beta APIs, editor mode, data-driven items, associated packs). | | ensureworld | — | Create or ensure a flat GameTest world exists for a project. | | deploytestworld | deploytest | Deploy a test world with project packs to Minecraft. Supports --launch. |

npx mct world -i d:\mycontent\myworld
npx mct world set -i d:\mycontent\myworld --betaApis true
npx mct deploytestworld -i d:\mycontent\myprojectfolder --launch

Info

| Command | Aliases | Description | | --------- | ---------- | ------------------------------------- | | version | ver, v | Display version and path information. |

Global Options

These options are available with all commands:

| Option | Description | | ---------------------------- | ---------------------------------------------- | | -i, --input-folder <path> | Input project folder | | -o, --output-folder <path> | Output folder for results | | -v, --verbose | Verbose output | | -q, --quiet | Quiet mode (suppresses non-error output) | | --json | JSON output format | | --debug | Enable debug mode | | --force | Force operation without confirmation | | --dry-run | Show what would be done without making changes | | --threads <n> | Number of parallel worker threads | | --all-commands | Show all commands including internal ones |

Configuring the HTTP Server

Use mct setserverprops to configure the serving domain and port:

npx mct setserverprops --domain 10.0.0.6 --port 80

The --domain should typically be the internal IP address of your machine. For example, in an Azure environment your external IP might be 10.20.30.2 but the internal IP might be 10.0.0.6.

Using the MCP Server with VS Code

Minecraft Creator Tools includes a Model Context Protocol (MCP) server that lets AI tools create and validate Minecraft Bedrock content interactively.

1. Install the package globally:

npm install -g @minecraft/creator-tools

2. Accept the Minecraft EULA:

Before the MCP server will work, you must accept the Minecraft End User License Agreement:

npx mct eula

Follow the prompts to review and accept. The MCP server will not start until the EULA has been accepted.

3. Configure VS Code:

Create a .vscode/mcp.json file in your project folder:

{
  "servers": {
    "minecraft-creator-tools": {
      "type": "stdio",
      "command": "mct",
      "args": ["mcp", "-i", "${workspaceFolder}"]
    }
  }
}

Or, to make the MCP server available in all your VS Code projects, open the Command Palette (Ctrl+Shift+P), search for MCP: Open User Configuration, and add:

{
  "servers": {
    "minecraft-creator-tools": {
      "type": "stdio",
      "command": "mct",
      "args": ["mcp"]
    }
  }
}

Trademarks

This project may contain trademarks or logos for projects, products, or services. Authorized use of Microsoft trademarks or logos is subject to and must follow Microsoft's Trademark & Brand Guidelines. Use of Microsoft trademarks or logos in modified versions of this project must not cause confusion or imply Microsoft sponsorship. Any use of third-party trademarks or logos are subject to those third-party’s policies.