Generate the base files needed to create a custom entity addon.
This page presumes you have already prepared your Bedrock geometry (model file), animation, and texture files. We recommend using the excellent (and free) Blockbench app to create these files. The entity name you use in Blockbench should be the same as used here, but with all lowercase letters, underscores instead of spaces, and without apostrophes e.g. ‘Hector's Dolphin’ becomes ‘hectors_dolphin’.
Documentation on creating addons is available here: https://bedrock.dev/. Minecraft Education Edition is currently at version 1.14.50.
Click a form field name to show a helpful hint :)
Addon Name (Must contain only alphanumeric characters, underscores (_), dashes (-) or whitespaces)
Description (A brief description of your addon)
Version (Use Semantic Versioning — in the form of MAJOR.MINOR.PATCH where MAJOR, MINOR, and PATCH are non‑negative numbers)
Namespace (The namespace your entity will be added with. The default namespace is ‘minecraft’, we don’t work for Mojang so we should use something else!)
Entity name (Use only alphanumeric characters, apostrophes & spaces — when lowercased, spaces converted to underscores and apostrophes removed — this should match the name you gave the entity in Blockbench)
Entity behaviours (Select all that apply) Walk Fly Swim
Entity size Choose a size for your entity where 1.0 is the size that you modelled it, 2.0 is twice the size, and 0.3 would be 30% of the modelled size. Adult: 0.1 0.2 0.3 0.4 0.5 0.6 0.7 0.8 0.9 1.0 1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 2.0 3.0 Baby: 0.1 0.2 0.3 0.4 0.5 0.6 0.7 0.8 0.9 1.0 1.1 1.2 1.3 1.4 1.5 1.6 1.7 1.8 1.9 2.0 3.0
Entity speed Choose a speed for your entity where 0.1 is normal animal speed, 0.3 is really fast, and 0.05 is slow like a snail. Speed: 0.9 0.8 0.7 0.6 0.5 0.4 0.3 0.2 0.1 0.09 0.08 0.07 0.06 0.05 0.04 0.03 0.02 0.01
Model (Attach the Bedrock JSON model file you exported from Blockbench)
Animation (Attach the Bedrock animation JSON file you exported from Blockbench — this presumes you have named your animations in the format ‘entity_name.animation.behaviour’ e.g. frog.animation.walk)
Baby (Does the entity have babies?) Yes
Breed / grow / tempt item (The item that will be used to breed and grow the entity and make it follow the player. Start typing to get suggestions)
Texture (Attach the entity texture file — these should be PNG files) Adult: Baby:
Transparency (Does the texture file have any transparent areas applied to the faces of the model?) Yes
Spawn egg colours (Use hexidecimal colour codes) Base colour: Overlay colour:
Sound (Attach a sound file for your entity to use — this should be an OGG file)
Loot (What item should the entity drop when killed? Start typing to get suggestions)
Biome (What biome should the entity naturally spawn in? — defaults to ‘animal’ — start typing to get suggestions)
Hostile mob (Is the entity hostile towards players?) Yes
Exploding (Should the entity explode like a creeper?) Yes