編輯器

出自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

畫廊[編輯]

參考[編輯]