Getting Started with Editor Extensions

How do you get started? Well, that depends on what you already know. There are a lot of parts to it and the more you know about each part, the easier it will be:

  • You have Minecraft Bedrock Preview running on a Windows PC.
  • You have worked with Resource Packs and Behavior Packs to change something in Minecraft. If not, you should start with Getting Started with Minecraft Add-ons.
  • You know how to use slash commands in Minecraft as shown in the Commands Introduction.
  • You have taken a look at Minecraft scripting and set up your programming environment so you can try it.
  • You know what an Application Programming Interface (API) is.
  • You have used Editor to edit a world. If not, you should start with the Editor Tutorial.
  • You would like to change the functionality of one or more of the Editor tools or at least know more about how to do it.

The Minecraft Bedrock Editor is a framework that is built into certain platform versions of Minecraft Bedrock Edition that is designed to allow creators to use more complex tools than the ones found in simple gameplay to build, edit, and test worlds. In fact, the Editor framework lets creators build their own tools to suit their own style of creation.

An Editor Extension is the collective name for a set of Resource and Behavior Packs that contain script and binary assets that get loaded into Editor at start up time.

The Extensions are written in TypeScript and are compiled into JavaScript for loading into the game. The compiler tools and various libraries required to do this are supplied in the Editor Extension Starter Kit.

Minecraft has a Scripting API that can be used to do some pretty amazing stuff. Editor has an API, too, and these two APIs are connected. Minecraft uses existing server-side scripting APIs (like SetBlock, Spawn, Camera, and slash commands) and enhances them with Editor-Specific APIs. See server-editor for a full reference of editor-specific APIs.

If you've never worked with an API before, it's worth taking the time to learn about them. It involves scripting (writing small amounts of code), so if you're new to that, you can find some excellent free resources on the Web to learn JavaScript and TypeScript.

Then, you could go through the Scripting tutorial.

After you get all the prerequisites out of the way, you could take a look at some examples of Extensions - there is a starter kit and GitHub repo.

Now you're ready to try one of the examples or get started building your own!