编辑器

来自Minecraft基岩版开发Wiki
编辑器
软件与应用程序
开发作者
运行平台
Windows
编写语言
  • C++
  • 基岩代码库
最新版本
发布日期
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

画廊[编辑]

参考[编辑]