编辑器¶

编辑器（Editor）是Minecraft基岩版国际版中提供的一种专用世界编辑工具模式。编辑器为创作者提供图形化的创作界面，用于高效构建、编辑、测试和导出世界内容。

概述¶

Minecraft编辑器是运行在基岩版引擎上的独立启动模式。与普通游玩流程不同，编辑器在游戏画面上叠加专用窗口、菜单、工具栏和操作栏，使创作者能够在世界内部直接进行多方块编辑。编辑器同时内置于基岩版的正式版（Retail）与预览版（Preview）中，只要安装了基岩版即已具备编辑器，无需额外下载。当前可用流程以Windows电脑、键盘和鼠标为主，不适用于移动端或主机。

编辑器不是新的游戏模式，而是帮助创作者完成世界构建、编辑、测试和导出的工具框架。编辑器扩展建立在游戏内置的JavaScript脚本能力与原生编辑工具之上，用于让创作者自行编写更复杂的编辑工作流。

与旧版中国版MC Studio的区别

旧版中国版MC Studio也曾把地图编辑器、关卡编辑器、逻辑编辑器、特效编辑器和界面编辑器统称为编辑器工具。那些工具属于中国版旧版开发工作流，与本页所述国际版Minecraft编辑器不是同一个系统；维护旧项目时可参见旧版中国版MC Studio工具链。

启动路径¶

常见启动流程可以概括为三步：

在Minecraft启动器中安装基岩版正式版或预览版（Minecraft Preview）。
创建桌面快捷方式，并将其目标设为编辑器协议地址（正式版为minecraft://creator/?Editor=true，预览版为minecraft-preview://creator/?Editor=true）。
通过该快捷方式直接进入编辑器。

在当前启动器版本中，可在启动器左侧选择Minecraft: Bedrock Edition，于创作者工具（Creator Tools）标签页中安装正式版或预览版。两个版本都内置编辑器；预览版会更早获得编辑器的新特性，因此创作者常以预览版作为编辑器的试用环境。

项目与世界¶

编辑器使用项目（Project）作为编辑工作空间。项目保存编辑状态、项目设置、导出设置和用于编辑的世界数据。项目可以导出为可游玩的.mcworld世界，也可以在测试世界流程中临时以普通玩法方式运行。项目不应简单等同于最终发布的世界文件；它更接近用于持续编辑和导出的源数据。

创建项目时，创作者可以设置项目名称、导出相关设置和通常的世界选项。项目启动后，编辑器会显示欢迎或快速开始窗口，用于说明移动方式、工具入口和常用链接。

界面¶

编辑器界面由多个可移动、可折叠、可关闭的窗口组成。常见区域包括：

菜单栏：提供文件、视图、帮助、界面设置等入口。
工具栏：列出选择、刷子、填充、线条、铅笔、挤出等编辑工具。
操作栏：放置可快速执行的常用动作。
方块快捷栏：选择当前用于编辑的方块。
工具窗口：显示当前工具的形状、尺寸、模式和其他参数。
指南针：显示当前朝向，并可用于快速对齐视角。

编辑器还提供界面缩放、字体大小和主题等UI设置。这些设置只影响编辑器界面显示，不改变项目内容。

主要功能¶

工具系统¶

编辑器提供一组用于世界编辑的工具。选择工具用于选取三维区域；刷子工具用于按形状快速绘制方块；填充工具用于替换或填充区域；线条、铅笔、挤出、缩放、尺规等工具用于处理不同类型的构建任务。不同工具通常具有各自的参数窗口和快捷键。

移动与视角¶

编辑器提供自由飞行相机。工具模式下通常需要按住鼠标右键再使用W、A、S、D、Space和Shift移动。视图设置中可以调整飞行速度。对准远处方块按G可以使用视线传送功能移动到目标位置。

撤销、重做与结构操作¶

编辑器内置撤销和重做功能，允许创作者回退或恢复编辑操作。编辑器还支持对选定区域执行复制、剪切、粘贴、旋转、镜像和预览粘贴等结构化操作，适合处理大型建筑、重复构件和对称结构。

世界选项¶

世界选项提供对编辑过程中常见世界状态的快速控制，包括暂停实体模拟、切换维度、调整时间、修改天气、打开导航面板以及进入测试世界。测试世界会以可游玩方式运行当前项目；测试期间所做的改动不会保存回项目，退出测试后可返回编辑器继续编辑。

编辑器扩展¶

编辑器支持通过脚本API创建扩展。编辑器扩展可以添加自定义工具、面板、操作和工作流，用于扩展默认编辑能力。编辑器扩展使用@minecraft/server-editor脚本模块，并依赖编辑器环境提供的接口。若工作不在编辑器内运行，而是在普通世界中测试脚本功能，则仍需在实验性玩法中开启Beta APIs。

编辑器与编辑器扩展API目前仍在持续维护，相关入口覆盖概览、安装、教程、扩展入门以及@minecraft/server-editor模块本身，因此不应把它视为只在早期预览阶段短暂出现过的能力。

与网络协议¶

协议中存在EditorNetworkPacket，并带有Route To Manager、Raw Variant Name和Raw Variant Data等字段。这表明编辑器不仅是单机界面叠层，也已经在游戏层协议中拥有专门的消息通道；当编辑器与BDS或其他联网工作流结合时，这一点尤为重要。

与BDS¶

Windows版基岩版专用服务器可以承载编辑器项目。以命令行参数Editor=true启动BDS时，服务器可以从空世界创建编辑器项目；也可以将已有编辑器项目放入服务器worlds目录，再通过server.properties指定level-name。在这种状态下，客户端连接服务器会进入编辑器会话，且客户端版本必须与服务器版本匹配。

与存档¶

编辑器项目可以导出为普通世界，也可以将普通世界导入编辑器进行编辑。编辑器项目与普通世界共享基岩版世界数据基础，但项目还包含编辑器工作流所需的附加状态和导出信息。因此，用于正式发布、备份和跨设备分发时，通常应导出为.mcworld或复制完整项目目录，并避免只保存部分世界文件。