Skip to main content
Minecraft Creator Tools is available as both a command-line tool and a web application. This guide covers installing the CLI tool.

System Requirements

Node.js

Latest LTS version recommended

NPM

Comes bundled with Node.js
Download Node.js from nodejs.org. The installer includes npm (Node Package Manager).

Installation Methods

PowerShell Configuration (Windows)

If you’re using PowerShell on Windows, you may need to adjust execution policies for remote signed scripts.
Only change execution policy if you understand the security implications. This allows PowerShell scripts to run on your system.
Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Verify Installation

Confirm the installation by running:
npx mct
You should see output similar to:
┌─────┐
 Minecraft Creator Tools (preview) command line
 ┏▀┓ See https://mctools.dev/ for more info.
└─────┘

Usage: mct [options] [command]

Minecraft Creator Tools v[version]

Options:
  -i, --input-folder [path to folder]     Path to the input folder
  -o, --output-folder <path to folder>    Path to the output project folder
  -show, --display-only                   Show messages vs. output report files
  -lv, --log-verbose                      Show verbose log messages
  -h, --help                              Display help for command

Commands:
  validate [suite] [exclusions]           Validate the current project
  create [name] [template] [creator]      Creates a new Minecraft project
  deploy <mode>                           Copies Minecraft files to destination
  info                                    Displays project information
  ...

Web Application

Alternatively, use Minecraft Creator Tools online without any installation:

MCTools.dev

Access the web-based version with full validation, editing, and project management features.

Package Information

NPM Package

View package details and version history

GitHub Repository

Source code and issue tracking

Troubleshooting

  1. Restart your terminal/command prompt
  2. Verify npm’s global bin directory is in your PATH:
    npm config get prefix
    
  3. Add the bin directory to your system PATH if needed
If you encounter permission errors during global installation:
sudo npm install -g @minecraft/creator-tools
Or configure npm to install packages in your home directory:
npm config set prefix ~/.npm-global
export PATH=~/.npm-global/bin:$PATH
If you see errors about script execution:
  1. Open PowerShell as Administrator
  2. Run the Set-ExecutionPolicy command shown above
  3. Restart your terminal

Next Steps

Quick Start

Create your first project and run validation

CLI Reference

Explore all available commands

Build docs developers (and LLMs) love