Bedrock Editor

{
 "title": "Bedrock Editor",
 "rows": [
 {
 "field": "\n* (link to File:Mojang Studios logo.svg article, displayed as 20px|link=Mojang Studios|alt=Mojang Studios logo) (link to Mojang Studios article, displayed as Mojang Studios) <small>[https://minecraft.net/credits (Credits)]</small>\n* (link to File:Xbox Game Studios.svg article, displayed as 25px|link=Xbox Game Studios) (link to Xbox Game Studios article, displayed as Xbox Game Studios)",
 "label": "Author(s)"
 },
 {
 "field": "(link to File:Windows wordmark.svg article, displayed as x20px|Windows|link=wikipedia:Microsoft Windows)",
 "label": "Platform(s)"
 },
 {
 "field": "(link to File:C++.svg article, displayed as x20px|C++|link=wikipedia:C++) (link to wikipedia:C++ article, displayed as C++)<br>Bedrock Codebase",
 "label": "Written in"
 },
 {
 "field": "'''Stable''': (link to Bedrock Editor_1.4.0 article, displayed as 1.4.0)<br>\n'''Preview''': (link to Bedrock Editor_26.40.27 article, displayed as 26.40.27)",
 "label": "Latest version"
 },
 {
 "field": "'''Preview:''' March 8, 2023<br>\n'''Stable:''' December 3, 2024",
 "label": "Release date"
 },
 {
 "field": "Same as ''(link to Bedrock Edition article, displayed as Bedrock Edition)'' and ''(link to Minecraft Preview article, displayed as Minecraft Preview)''.",
 "label": "Size"
 },
 {
 "field": "No",
 "label": "<span style=\"white-space:normal\">Source available</span>"
 },
 {
 "field": "\n* [https://learn.microsoft.com/minecraft/creator/documents/editoroverview Documentation]<br>\n[https://github.com/Mojang/minecraft-editor GitHub Repository Website]",
 "label": "Links"
 }
 ],
 "invimages": [],
 "images": [
 "Ore UI - \"Tutorial Start\" Image.png"
 ]
}

The Bedrock Editor, also referred to as Minecraft: Bedrock Editor or simply the Editor, is an in-game tool that can be used to edit worlds through projects. It is customizable through the use of scripting.

The Bedrock Editor uses the same app as Minecraft and Minecraft Preview, in the "Editor" state. It can be opened from the "Creator Tools" tab in the Bedrock Edition section of the Minecraft Launcher. A desktop shortcut can be created to launch the Editor directly without opening the Minecraft Launcher. This should be an internet shortcut with minecraft://creator/?Editor=true for the stable version, or minecraft-preview://creator/?Editor=true for Preview.

Opening the Bedrock Editor can also be done by pressing  + , and entering minecraft://creator/?Editor=true for the stable version, or minecraft-preview://creator/?Editor=true for Preview.

Bedrock Dedicated Server can also enable the Editor for clients. To launch BDS with the Editor, enter bedrock_server.exe Editor=true in a command prompt. This will create a new project on the server, and only works if the server doesn't contain any worlds. An existing project can be applied to a server by adding the project to the server's worlds folder and specifying the world name in server.properties. Only players on an Editor client can join compatible servers with a project to edit on the server.

Using the tool starts with creating a new Project. A project is similar to a world, but a project is not "played" until it is exported, and stays in the initial creation state during editing, meaning that several game settings such as the bonus chest can still be enabled after editing. Achievements are always disabled for projects and worlds created with the project.

New projects can be created from the main menu. All existing projects are shown in the "Projects" list, with the options to edit a project, create a new project, or import a world file (.mcworld or .mcproject zip). The player can join multiplayer projects from the "Friends" tab or join external servers from the "Servers" tab. The settings icon in the top-right opens the same settings menu as in regular gameplay. Pressing a project in the list opens the editor for that world.

Creating a new project has the same options as a new world in Minecraft, with the exception of Hardcore mode and Marketplace add-ons. The world type option has one additional preset, "Void world", which generates an empty world across all dimensions with a small grass block platform in the Overworld.

Editing a project has the same options as the regular edit world screen (see World Options § Classic UI), but these options affect the world only in test mode or for exporting. The edit world screen allows add-ons and experiments to be enabled, which can't be done from the Editor. A project can also be exported as project file to import it in the Editor, as world file to import it in Minecraft, or as template to import its world settings and add-ons.

The Editor GUI uses Ore UI, and consists of several bars on the sides. Windows and pop-up bars can be closed and adjusted in scale and position towards the world preview. Several options and buttons have blue tooltips that appear when hovering over the option. These show hotkeys, a short description of the option, and sometimes a video explaining the feature.

The statistics bar at the bottom shows the camera's coordinates, the difference (Δ) in coordinates of the gizmo, the coordinates of the gizmo, the ID of the hovered block, and the ID of its biome.

The menu bar on the top has five tabs with options. Unless stated else, each of these buttons opens the respective window on the right side. See the respective sections below for more information about the functions.

File

File contains a list of actions and settings that handle the Project.

• Test World
• Export
• Publish to Realms
• Settings
• Keyboard Settings
• Save & Quit
  • Saves the project and returns to the main menu.

Edit

Edit contains a list of actions used to add and remove things from the world.

• Undo ( + )
  • Undos the latest action performed in the Editor.
• Redo ( + )
  • Reverts an undo action.
• Cut ( + )
  • Copies the selected blocks/entities to the clipboard and removes them.
• Copy ( + )
  • Copies the selected blocks/entities to the clipboard.
• Delete ()
  • Deletes the selected blocks/entities. Blocks are replaced with air.
• Deselect ( + )
  • Deselects a selected area.
• Fill ( + )
  • Fills the selected area with the block selected in the hotbar.

View

View contains a list of options to show menus in the Editor.

• Game menu ( + )
  • Closes the Editor GUI and opens the game menu. The game menu looks similar to the menu in regular Minecraft but the Marketplace, profile screen and Dressing Room are inaccessible.
• Log Panel ( + )
• Structures
• Jigsaws

World

World contains a list of options that change the attributes of the world.

• Pause Entities
  • Toggles to pause all entity movements and suspend their AI.
• Navigation
• Locate ( +  + )
• Time of Day
• Weather
  • Opens a sub-menu to set the current weather to clear, rain, or thunder.
• Chunk Management
• Biome Data Assignment
• Vibrant Visuals
• Dimensions
  • Opens a sub-menu to teleport the player to the Overworld, the Nether, the End, or available custom dimensions.

Help

Help contains a list of resources and information to teach about the Editor.

• Tutorial
• What's New
• Documentation
  • Opens the official documentation page for the Editor.
• Feedback
  • Opens the feedback post about the Editor.
• Samples
  • Opens the Editor samples page on GitHub.

The action bar is located below the menu bar and contains buttons on the left and right side. On both sides, a set of buttons can be selected for quick actions. If there are more buttons than space on one side, a button appears to switch between pages. Right-clicking a button or selecting the triangle in the bottom-right opens the button selection panel with an option to remove the button. Most of these buttons are also available from the menu bar above. The available buttons are:

In the middle of the action bar is the block hotbar, which is used for several placing and filling actions. A block in the hotbar can be selected using the 1-9 hotkeys, or by selecting a block. Double-clicking a slot opens a pop-up to pick a block.

The block picker shows in which block the slot changes, with a list of all blocks below. The list shows the inventory icon as well as the ID, and can be filtered with a searchbar above. The list can also be sorted by color, and the exact color can be picked with a HEX graphical color picker. There is also a recently used tab below.

The block picker allows to switch the hotbar slot to a list of blocks. Lists are shown in the "Hotbar" window on the right, per hotbar slot. When performing an action with a list, such as filling, the blocks will be randomly selected from the list. The weight of each block can be adjusted, and blocks can be added or removed to a list.

With the menu button next to the hotbar, a set hotbar can be saved to a name. Saved hotbars can be selected from this menu or with the arrow buttons next to the hotbar. A saved hotbar can be overwritten with the selected hotbar with the "Save to Hotbar" option. The "Hotbar" window on the right can be opened to change hotbars and lists.

The world preview can be highlighted with  +  (viewport focus). The camera can be moved by moving the mouse while holding right click. Horizontal movement is done through , , , and . Vertical movement is done through (up) and (down).

Scrolling on the mouse moves the camera in the facing direction. The camera can be dragged over the world by holding the middle mouse button and moving the mouse.

Selecting blocks and areas can be done with the selection tool by left-clicking. See § Tools below for more information.

Crosshair mode can be enabled on the action bar or with  +  twice, and simply opens the world in regular Creative mode. Crosshair mode can be left by pressing or  + . All features from Creative mode are available, including the hotbar and Creative inventory, but not certain GUIs and commands. Additionally, the player can phase through blocks like players in Spectator mode.

Upon first launch, the player is welcomed with a "What's New" window and a tutorial. Both can be opened at any time from the menu bar.

The What's New window has a list of new features in the latest update. New features are marked with a batch notification until the player opens them, or checks the "Clear content badges" button.

The tutorial consists of several pop-ups with tasks. After completion of all tasks (marked with a checkbox), the next tutorial pop-up opens. This tutorial shows some information about the GUI, controls, and the selection and brush tools.

The Navigation panel is used for the location of the camera in the world previewer. At the top, the "Show Map" option enables a map preview. The map preview uses the same layout and colors as in-game maps, but it is always centered around the player, with a marker. The map size can be adjusted between 64×64, 128×128, and 256×256 blocks. The map can be refreshed with a button below.

The players current XYZ location is shown below the map. By entering different values for the location, the player can teleport to any coordinates.

Below the map is a list of players in the world showing the colors of their map markers. A button allows to teleport to a player's location.

The Navigation panel allows to store locations. By pressing the "+" button, a new location with a custom name can be added which defaults to the current coordinates. Saved locations show as markers on the map, with a customizable color using a HEX graphical color picker. A single location can be selected in the panel to edit it, teleport, or delete it.

On the bottom is a filter & sort bar which allows to search locations, sort them A–Z/Z–A, and multiselect to delete locations.

The Locate window, opened with  +  + , allows to quickly perform the /locate biome command. A biome searchbar allows to quickly find a biome with the ID or display name.

The Time of Day Settings are used to quickly change the current in-game time. The time can be set to any integer or clock value, depending on the clock type used. The daylight cycle option can also be changed here. Below, a time preset (e.g. noon, sunset, midnight) can be selected, or the time can quickly be adjusted with a slider.

See § Test world below for more information about specific time options.

Tools can be selected from the left toolrail.

The Chunk Management window allows to delete or regenerate entire chunks. Multiple regions can be added by inputting coordinates, or using the Selection tool. Selecting a region instantly teleports to a view of the region, and there is an option to delete it. The coordinates do not have to conform to chunk boundaries, but actions will always select the full chunks within the region, so it might extend outside of the selection.

• Regeneration resets the chunks and applies the regular (or customized) world generation, deleting all altered blocks and enties inside.
  • "Exclude Region List" can be used to invert the selection and only keep the chunks that are in the region list.
  • There is also an option to regenerate the entire world, in all dimensions.
• Delete simply deletes all blocks and entities and leaves a chunk hole behind.

Vibrant Visuals can be completely customized with resource packs, and the Bedrock Editor provides an interface to easily create Vibrant Visuals resource packs.

From the Vibrant Visuals Settings window, Vibrant Visuals can be enabled for the world previewer. Closing the window might reset some settings, so it is recommended to export the settings to the clipboard regularly. Vibrant Visuals settings are not saved for a project.

The Vibrant Visuals Settings has six tabs: Water, Global Lighting, Atmospheric Scattering, Color Grading, Cubemaps, Shadows, and Local Lights.

• The water settings allow the water color and fog color to be changed with three particle effects. Water caustics can be enabled and adjusted in length, power, and scale. An additional feature called "Waves" can be enabled and customized. This is not enabled in the default Vibrant Visuals and creates detailed animated wave effects on water surfaces. Many settings, such as depth, frequency, pull, shape, and speed can be adjusted.

• Global lighting settings allows for customization of global light sources, including the sun, moon, and End flashes. The color spectrum, illuminance, and orbital offset can be adjusted and is previewed with graphical projections. Non-directional light sources, including emissiveness, ambient lighting, and sky lighting, can be customized in saturation, color, and intensity, respectively.

• Atmospheric scattering allows customization of some atmospheric effects, such as different sky colors. The strength, shape, and blending of scattering from directional light sources can also be adjusted.

• Color grading changes how some color effects are changed as a post-processing effect. RGB values for different color grading aspects can be adjusted. The tone mapping operator can be selected from preset curves.

• Cubemap textures are always rendered around the player and can be reflected by water. It can be affected by various types of lighting, which is customziable.

• Shadow effects can be selected between the default "blocky" shadows and regular soft shadows. The texel size can be adjusted which changes the size of the shadow pixels.

• Light settings for every block with configurations in the resource packs can be customized.

For more information about individual options and key frame graphs, see Vibrant Visuals § Customization.

All adjustments can be exported into a resource pack. The game automatically generates a resource pack which can be applied to the project, or other worlds without further modification.

Configurations per setting group can be assigned to every biome in the game (including custom biomes). Each setting group allows to create a configuration file, or modify existing ones, with a customizable namespace and name. To quickly import settings, or add more options to key frames or local lighting, the raw JSON contents of a configuration file can be imported.

Setting groups can be applied to multiple biomes using a separate biome config mapping window.

With the test world feature, the player can playtest the world with regular gameplay. Changes won't be saved (including options changed in the pause menu), and test world is only available in singleplayer. Cheats are enabled for test mode, and some settings can be changed before playing. The pause menu has an option to return to the Editor instead of leaving the game.

The project can be exported as a world file from inside the Editor. There are several export options, some of which can also be changed from the pause menu or edit world screen. Options exclusive to the Editor are listed here. World options that are usually disabled after world creation are also available, including Hardcore, Starting Map, and Bonus Chest. Add-ons or experiments cannot be changed.

The /project command can also be used to export the project, with the world settings defined in the edit world screen.

Export Type

Allows the file extension to be changed, influencing how the world is imported in the Editor or in Minecraft. This can only be set to regular "Playable World" for now.

These settings are only available when cheats are enabled.

The "Export" button below instantly exports the world to the regular Minecraft world list. All options can be reset to their default state with a button next to it.

Projects can be exported as worlds to owned Realms servers. The "Publish to Realms" window has the same exportation options as when exporting a world, and the Realm and world slot can be selected. "Download" downloads the world currently stored on that slot to the device, and "Publish" replaces the selected slot with the world.

In addition to the game settings accessible from the main menu and the pause menu, some settings related to the Editor GUI can be changed here.

Keybinds for almost all functions in the Editor can be customized. The Kyeboard Settings window can be opened only from the action bar, and lists all keybinds in several tabs. To change a keybind, select the input box and press a key to change it into that key. Right-clicking the keybind or clicking the button on the right clears the keybind. The second button on the right resets the keybind to the default state. Changes need to be saved with a button at the bottom, and all keybinds can be restored to their default state, or reset to the previously saved state.

Next to each keybind is an option to make the keybind "exclusive". This makes single-key actions activate only if no other modifiers are present, or if the specified modifier is used alongside the key. By default, all single keybinds are marked as exclusive.

The following keybinds are only available when the corresponding tool is activated.

• In the first build (0.3), a link referenced as an example scripting pack was jokingly put in the code. The link redirects to Rick Astley's song "Never Gonna Give You Up".

• 👁 Default project thumbnail
  
  Default project thumbnail
• 👁 Flat project thumbnail
  
  Flat project thumbnail
• 👁 Void project thumbnail
  
  Void project thumbnail

• 👁 Projects tab
  
  Projects tab
• 👁 Servers tab
  
  Servers tab

• 👁 The "General" tab
  
  The "General" tab
• 👁 The "Advanced" tab
  
  The "Advanced" tab
• 👁 The "Multiplayer" tab
  
  The "Multiplayer" tab
• 👁 The "Cheats" tab
  
  The "Cheats" tab
• 👁 The "Resource packs" tab
  
  The "Resource packs" tab
• 👁 The "Behavior packs" tab
  
  The "Behavior packs" tab
• 👁 The "Experiments" tab
  
  The "Experiments" tab

• 👁 The edit screen for a project
  
  The edit screen for a project

• 👁 The tool "Selection" tab
  
  The tool "Selection" tab
• 👁 The tool "Brush Paint" tab
  
  The tool "Brush Paint" tab
• 👁 The tool "Pencil" tab
  
  The tool "Pencil" tab
• 👁 The tool "Paste Preview" tab
  
  The tool "Paste Preview" tab
• 👁 The tool "Line" tab
  
  The tool "Line" tab
• 👁 The tool "Ruler" tab
  
  The tool "Ruler" tab
• 👁 The tool "Smart Fill" tab
  
  The tool "Smart Fill" tab
• 👁 The tool "Terrain" tab
  
  The tool "Terrain" tab
• 👁 The tool "Extrude" tab
  
  The tool "Extrude" tab
• 👁 The tool "Repeater" tab
  
  The tool "Repeater" tab
• 👁 The tool "Summon" tab
  
  The tool "Summon" tab
• 👁 The tool "Entity Inspector" tab
  
  The tool "Entity Inspector" tab
• 👁 The tool "Workbench" tab (Options)
  
  The tool "Workbench" tab (Options)
• 👁 The tool "Farm Generator" tab
  
  The tool "Farm Generator" tab
• 👁 The tool "Block Inspector" tab
  
  The tool "Block Inspector" tab

• 👁 The Location Pointer Idle entity
  
  The Location Pointer Idle entity
• 👁 The Location Pointer Selected entity
  
  The Location Pointer Selected entity
• 👁 The Map Marker entity
  
  The Map Marker entity
• 👁 The Ruler entity
  
  The Ruler entity
• 👁 The Ruler Idle entity
  
  The Ruler Idle entity

• Ore UI, the Bedrock Edition UI refresh
• Add-on
• Resource pack
• Behavior pack

• Editor Overview
• Installation Guide
• Tutorial
• Action Bar
• Vibrant Visuals
• Keyboard Inputs
• Paste Preview
• Tool Mode
• Workflow
• World Options
• Building Editor Extensions
• More topics
• Script API
• Editor API

• Minecraft Editor
• Editor Extension Starter Kit
• Extension Samples

• Editor Feedback
• How to Get the Minecraft: Bedrock Editor

• Discord channel