Software and preparation
Before you can start creating addons, you first have to install the required tools and applications. While development will be easiest on Windows 10, we have provided mobile alternatives for both Android and iOS, where applicable.
Download Minecraft Bedrock Edition
Picking an Editor
Addons can be created using any text editor, however it's much more comfortable to work in a dedicated editor. A good editor can give you code-completion, error-detection, and in-editor documentation.
There are strong opinions about the best editor for beginners, but generally speaking you cannot go wrong selecting either VSCode, or bridge. If you are mobile, you will need to use a mobile alternative.
VSCode is a general purpose text-editor and IDE. With VSCode, you will be able to edit your addons in plain-text, guided along by a powerful array of extensions and addons. VSCode is a great option for programmers and advanced users.
To get started with setting up bridge., check out our getting started guide.
Tips when following the guide with bridge.:
- To create individual files you can open the new file window with
ctrl + nand look in the
Simple Filescategory. The other categories can be used to create multiple files to create a whole block or entity for example.
- To see your files in a traditional folder structure, disable
Settings > Generalthe settings can be accessed by pressing
ctrl + ,.
For further guidance on the editor, feel free to contact us on Twitter. bridge. also has an official Discord server, where you can hear the latest bridge. news, get help with the editor and extensions and get addon help.
- Blockbench is a 'boxy 3D model editor' typically used to create Minecraft models, textures and animations. Also provides a web-browser version which is compatible with mobile.
This guide will walk you through the first stages of addon development, but it is not comprehensive! To learn more about addons, you will have to use and reference other sources of information, which we will link to here.
Join the Discord
The best place to get help with this guide is to join the discord server.
Minecraft's vanilla files are a good source of reference material. You should download these packs, and store them on a convenient location on your computer. When you need an example of an item, or entity, or animation, you can reference these files for inspiration.
There are many good sources of Addon documentation. Familiarize yourself with all of them, and consider bookmarking them.
- bedrock.dev: Reference documentation.
- wiki.bedrock.dev: Tutorials and guides.
- MS Docs: The official microsoft creator portal for addons.
Troubleshooting and Additional Help
- If the json format is very tricky for you, consider reading the understanding-json guide.
- If you get stuck with an odd error, consider reading the troubleshooting guide.
- If you still haven't found a solution, feel free to join our Discord server.
What you have learned
- To develop Addons, you need an Editor
- Other useful software:
- Blockbench for creating Minecraft Models like Entities
- Image Editors for creating Textures and Images
- Use the Vanilla Example files as a reference or inspiration for your addons
- How to solve problems and get help
Your progress so far
What you've done:
- [x] Installed the necessary software
- [x] Downloaded the Vanilla Example files
- [ ] Locate your
com.mojangfolder and create your addon's workspace.
- [ ] Create the manifest and pack icon for your first addon