编辑器

来自Minecraft基岩版开发Wiki
编辑器
软件与应用程序
开发作者
运行平台
Windows
编写语言
  • C++
  • 基岩代码库
最新版本
1.21.10.24
发布日期
Preview：2023年3月8日
年龄分级
与基岩版一致
程序大小
  • Preview ≈ 1.2 GB[1]
授权协议
使用条款
开源情况
否
外部链接
用编辑器模式打开游戏后，游戏直接进入选择世界菜单而非主菜单，此时“设置”按钮被调整到了右上角

编辑器（Editor），亦称基岩版编辑器（Bedrock Editor）、Minecraft编辑器（Minecraft Editor）或者Minecraft基岩版编辑器（Minecraft Bedrock Editor），是一款游戏内置的世界编辑器，可用于游戏内通过更简单便捷的方式快速进行多方块放置。它支持通过脚本API进行自定义。目前仅在Windows平台的Minecraft Preview中可用。

项目[编辑]

编辑器模式中的世界称为项目（Project），创建世界时，存档名默认为“我的项目”而非“我的世界”。启用编辑器后，游戏会屏蔽选择世界菜单中的世界；在未启用编辑器时，游戏会屏蔽选择世界菜单中的项目。在设置的“存储”选项中可查看所有的世界和项目，无论当前是否开启编辑器。

文件[编辑]

项目可被保存为MCPROJECT文件（扩展名为.mcproject），其本质为该存档文件的压缩包，与MCWORLD文件结构相同。

  •  MyProject.mcproject
    •  db
    •  level.dat
    •  level.dat_old
    •  levename.txt
    •  world_icon.jpeg

其中存档数据文件包含三个与编辑器相关的NBT字段：

  •  level.dat
    •  editorWorldType：编辑器世界类型。
    •  isCreatedInEditor：是否在编辑器中创建。
    •  isExportedFromEditor：是否从编辑器中导出。
    • ……

导出[编辑]

在世界编辑菜单中可导出项目为MCPROJECT文件，也可导出为MCWORLD文件或MCTEMPLATE文件。

点击编辑器界面左上角“文件”选项，选择“导出为”，然后点击“可玩的世界”可将当前项目导出为MCWORLD文件。导出路径为C:\Users\<用户名>\AppData\Local\Packages\Microsoft.MinecraftWindowsBeta_8wekyb3d8bbwe\LocalState\games\com.mojang\projectbackups。

导入[编辑]

双击MCPROJECT文件可直接导入该项目到游戏中。在启用编辑器的情况下也可以导入MCWORLD文件，这会导致其被转化为项目并展示在选择世界菜单中。

启用[编辑]

快捷方式[编辑]

File:Minecraft Bedrock Editor Welcome.png
编辑器的欢迎界面
  1. 在Windows上安装1.19.80.20或更高版本的Minecraft Preview。
  2. 右键单击桌面，从上下文菜单中选择“新建”，然后选择“快捷方式”。
  3. 键入对象的位置：minecraft-preview:?Editor=true。
  4. 单击“下一步”并为快捷方式命名，例如Minecraft Editor。
  5. 打开新创建的快捷方式并确保使用Minecraft Preview打开链接以启动编辑器。

或者，可以通过按⊞ Windows + R，输入minecraft-preview:?Editor=true，然后点击“确定”，再使用Minecraft Preview打开链接。

以上启动方法计划在基岩版编辑器离开Minecraft Preview时删除。

项目文件[编辑]

通过双击MCPROJECT文件可直接以编辑器模式打开Minecraft Preview，并将其导入。

功能[编辑]

启用编辑器会使游戏禁用全局资源、市场、服务器和更衣室。在项目设置菜单中仍然可以使用资源包。

编辑器模式下的游戏暂停菜单

配置文件[编辑]

编辑器的配置文件是位于C:\Users\<用户名>\AppData\Local\Packages\Microsoft.MinecraftWindowsBeta_8wekyb3d8bbwe\LocalState\games\com.mojang\minecraftpe的一个名为editorOptions.txt的文本文件，其中包含了编辑器的各种选项设置数据。

选项[编辑]

选项名称 值类型 有效值 默认值 解释 加入版本
Editor.UISettings.SessionScaleModifier 整数 25/50/75/100/125/150 100 设置UI比例。值为百分比。 1.19.80.20
Editor.UISettings.FontZoom 整数 50/75/100/125/150/175/200 100 设置UI字体缩放程度。值为百分比。 1.19.80.20
Editor.UISettings.Theme 字符串 Dark/Light/Redstone/HighContrast Dark 设置UI主题，共有四种主题：Dark（深色）、Light（浅色）、Redstone（红石）和High Contrast（高对比度）。 1.19.80.20
Editor.UISettings.Window.Data.EditorUI.ControlDemo JSON对象 窗口数据格式 ControlDemo窗口默认值 1.19.80.20
Editor.UISettings.Window.Data.EditorUI.LogPanel JSON对象 窗口数据格式 LogPanel窗口默认值 日志面板参数。 1.19.80.20
Editor.UISettings.Window.Data.EditorUI.SelectionToolPanel JSON对象 窗口数据格式 SelectionToolPanel窗口默认值 选择工具面板参数。 1.19.80.20
Editor.UISettings.Window.Data.EditorUI.WelcomePanel JSON对象 窗口数据格式 WelcomePanel窗口默认值 欢迎面板参数。 1.19.80.20

窗口数据格式[编辑]

编辑器窗口数据以JSON格式保存,它将被作为选项的值传入。例如：{"expanded":true,"left":0,"top":42,"visible":false}

其结构如下：

  • ：根对象。
    •  expanded：控制窗口是否展开。
    •  visible：控制窗口是否可见。
    •  left：控制窗口左边缘与屏幕边缘的距离，以像素为单位。
    •  top：控制窗口上边缘与屏幕边缘的距离，以像素为单位。

配置文件中每个窗口的数据的默认值如下：

窗口 参数默认值
expanded visible left top
ControlDemo true false 0 42
LogPanel true false 0 42
SelectionToolPanel true true 0 42
WelcomePanel true true 0 42

接口[编辑]

编辑器扩展接口基于脚本API开放，使用JavaScript语言编写。通过从脚本API中导入@minecraft/server-editor模块即可接入编辑器扩展接口。

要导入编辑器扩展接口模块，需先在行为包的清单文件中添加此模块。 

{
  "module_name": "@minecraft/server-editor",
  "version": "0.1.0-beta"
}

然后在JS文件中使用import语句导入模块中的部分内容或整个模块，例如： 

import * as Editor from "@minecraft/server-editor";

历史[编辑]

基岩版
1.19.101.19.10.22加入了与编辑器相关的语言文件。
1.19.801.19.80.20加入了编辑器，仅在Windows平台上的Minecraft Preview中可用。
1.19.80.21现在自定义方块可以被列入方块选择器中。
修复了在选定物体的粘贴预览中可能出现的深度冲突。
1.19.80.22禁用了物品掉落，以使撤销/恢复和剪切/复制/粘贴功能可以正常使用。
旧的切石机和下界反应核不再被列入方块选择器中。
1.20.01.20.0.20已弃用的方块不再被列入方块选择器中。
方块选择器中的方块现在按字母顺序排序。
处于工具模式的玩家不再会死亡。
1.20.101.20.10.23现在可以在编辑器中直接使用/scriptevent命令，而无需开启实验性API。
??将启用编辑器的快捷方式对象位置从minecraft:?Editor=true改为minecraft-preview:?Editor=true。

画廊[编辑]

  • 使用编辑器进行多方块放置编辑
    使用编辑器进行多方块放置编辑

参考[编辑]

  1. ↑ Minecraft Preview for Windows | Xbox
检索自“https://wiki.mcbe-dev.net/w/index.php?title=编辑器&oldid=23944”