This guide is a beginner tutorial, created to make it possible for more people to start ‘modding’ Minecraft Bedrock Edition. The guide is intended to be followed step by step, and will guide you from the very fundamentals, to being able to create advanced packs yourself.
An addon is basically the Minecraft Bedrock Edition (Windows 10, iOS, Android, Console) equivalent to Java mods. However, in contrast to Java, the Bedrock Edition API is officially maintained by Mojang itself, instead of the community.
In general, you can think of mods as modifying the game, and addons as adding-onto the game, following the development opportunities provided by Microsoft.
This guide be focused on creating addons on a Windows 10 PC for any Bedrock platform. However, the process is much the same when working on Android or iOS, although it is significantly more difficult. If something works differently on a mobile device, a note will state that.
This guide is written for the most-recent stable release of Minecraft Bedrock Edition. Many things won’t work in previous versions, and some will be changed in later ones. We will keep the guide as up-to-date is possible, so no need to worry.
Let’s start by setting up your tools, which you will use throughout the development of your addons. This section will cover exactly what software is needed, where to set up your addons, how to create a workspace where you can create your addons.
You will make your first steps in creating an addon here, by learning to create manifests and pack_icons (a.k.a initializing an addon), as well as learn to use some of the
.mc file extensions. No previous coding experience required. After you’ll create a testing World where you’ll be able to test the first feature of your addon - a custom /function. We’ll also learn about transpiling Add-ons and other
.mc file extensions.
Now it’s time to begin writing the first features of you addon. In this section you’ll create a simple “Gem” item, and a custom food, as well as learn to link textures via short names.
Next up are custom blocks. You’ll create a simple block, an animated block with a flipbook texture, a “Compass” block that has different textures for every direction and a block that imitates a Log.
Since you can now easily create custom blocks and items, it’s time to learn about their custom Loot Tables and Recipes. While we’re about it, we’ll take a short look on entity Spawn Rules too.
Now we’re finally ready to create… Custom Entities. Make sure to polish your existing knowledge a bit before starting this chapter, as it will be a bit more complicated. First, we’ll be using Blockbench to create the visuals, and then we’ll define the Behaviors!
The next sub-chapter: Here you’ll create custom particles and sounds and learn to trigger them via animations are auto triggers.
Let’s move to something way different now: World generation!
And, something way different from everything we’ve done before: the creation of custom Skin packs!
- 13.04.2020: The guide has been originally written and published by KaiFireborn#1551 on Discord here.
- 04.05.2020: Accessible by the domain/link
guide.bedrock.devthanks to destruc7i0n.
- 09.23.2020: Migration/porting of the Guide to the Wiki agreed upon and started with SirLich. Maintanence of the original website discountinued.
- 18.10.2020: Migration officially finished mostly thanks to ckhrysze and KaiFireborn. Currently, the Guide is fully OSS and accepting contributions from you.
- 27/03/2021: The wiki, including the guide, has been migrated to the Bedrock OSS Github Organization.
Table of contents
- Software and preparation
- Project Setup
- Loot Tables, Recipes, Spawn Rules
- Blockbench: Modeling, Texturing, Animating
- Render controllers
- Trade Tables
- Animation Controllers
- Particles and Sounds
- Custom Generation
- Skin Packs
- Download Example Packs
- Understanding JSON