creator-tools-cli

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Chinese

Run commands with:

bash

npx -y @minecraft/creator-tools@latest <command> [arguments] [options]

If the user has it installed globally,

mct <command>

works too. Most commands work on a project folder passed with

-i <folder>

: the folder that contains

behavior_packs/

and/or

resource_packs/

, or a single pack folder.

references/commands.md

lists every command with its arguments and options. It's generated from the CLI itself, so trust it over memory or older docs.

<command> --help

prints the same details.

使用以下方式运行命令：

bash

npx -y @minecraft/creator-tools@latest <command> [arguments] [options]

如果用户已全局安装，也可使用

mct <command>

。大多数命令都适用于通过

-i <folder>

参数指定的项目文件夹：该文件夹需包含

behavior_packs/

和/或

resource_packs/

目录，也可以是单个包文件夹。

references/commands.md

列出了所有命令及其参数和选项。该文档由CLI自动生成，因此比记忆内容或旧版文档更可靠。执行

<command> --help

也可查看相同的详细信息。

When the Minecraft Creator Tools MCP server is connected, prefer its tools for what they cover:

createMinecraftContent

(new mobs, items, and blocks),

designModel

designStructure

, the

writeImageFile*

tools, and

validateFile

. Use the CLI for everything else: whole-project validation, fixes, packaging, deploying, rendering, and the browser viewer.

当Minecraft Creator Tools MCP服务器已连接时，优先使用其覆盖的工具：

createMinecraftContent

（新建生物、物品和方块）、

designModel

、

designStructure

、

writeImageFile*

系列工具以及

validateFile

。其余所有操作请使用CLI：全项目验证、修复、打包、部署、渲染以及浏览器查看器。

Task	Command
Check a project for problems	`validate -i <folder>` (use the debug-addon skill, which wraps this)
Apply an automatic fix or upgrade	`fix --list` , then `fix <fix-name> -i <folder>`
Package for sharing	Validate first (debug-addon), then `exportaddon -i <folder> -o <output-folder>`
Copy packs into Minecraft (Windows)	`deploy retail -i <folder>` (or `preview` for Minecraft Preview)
Render a model to a PNG	`rendermodel <file>.geo.json <output>.png -i <folder>`
Render a vanilla block, mob, or item	`rendervanilla <block\|mob\|item> minecraft:<id> <output>.png`
Let the user browse or edit content	`view -i <folder>` or `edit -i <folder>`
Create a project from a template	`create <name> <template> <creator> <description> -y` (creates `./<name>` )
Add template content to a project	`add --list-types` , then `add <type> <namespace:name> -i <folder> -y`
Show project details	`info -i <folder>`
Show the installed version	`version`

任务	命令
检查项目问题	`validate -i <folder>` （使用封装了此命令的debug-addon技能）
应用自动修复或升级	先运行 `fix --list` ，再执行 `fix <fix-name> -i <folder>`
打包以便分享	先验证（使用debug-addon），再执行 `exportaddon -i <folder> -o <output-folder>`
将包复制到Minecraft（Windows端）	`deploy retail -i <folder>` （Minecraft预览版则使用 `preview` ）
将模型渲染为PNG	`rendermodel <file>.geo.json <output>.png -i <folder>`
渲染原版方块、生物或物品	`rendervanilla <block\|mob\|item> minecraft:<id> <output>.png`
让用户浏览或编辑内容	`view -i <folder>` 或 `edit -i <folder>`
从模板创建项目	`create <name> <template> <creator> <description> -y` （将在当前目录下创建 `./<name>` 文件夹）
向项目添加模板内容	先运行 `add --list-types` ，再执行 `add <type> <namespace:name> -i <folder> -y`
显示项目详情	`info -i <folder>`
显示已安装版本	`version`