ADDON·STUDIO
Bedrock behaviour pack + resource pack
drag to spin
How it looks placed down
Every face needs a texture, but they can share one — a plain block uses a single texture on all six. Add another and tick which faces it covers, the way grass has a green top, a brown bottom and a mixed side. A texture left blank makes that face invisible.
Tools
Brush 1
Selection
Colour
Opacity 100%
Recent
Palette
Canvas

Nothing here yet

Add an item or a block from the list on the left and it will show up here. Everything you make ends up in one .mcaddon file you can open straight into Minecraft.

What this recipe makes

ResultThe item or block that comes out. Vanilla like minecraft:redstone, or one of your own.
Internal nameNames the recipe files. Never seen in game.a-z, 0-9 and _
Add the recipes themselves on the Recipes tab. You can put several on one entry.

Vanilla override

Which block or itemType any vanilla ID and its texture slots are filled in for you.
Rename it toChanges the name shown in game. Leave blank to keep the original.
Treat it asOnly needed if the ID is not recognised.
You can retexture it, rename it and give it recipes. You cannot change how it behaves — hardness, drops and light are built into the game.

Function

Function nameRun it in game with /function <name>.a-z, 0-9 and _
Note to yourselfA reminder of what this one is for. Not exported.
CommandsOne per line. A leading slash is fine — it gets stripped on export.
Call another functionAdds a line that runs one of your other functions.

Identity

Display nameWhat it is called in game.
Internal nameThe ID you type in commands. Yours becomes mypack:ruby_sword.a-z, 0-9 and _
Creative tabWhich tab of the creative menu it appears in.
Join a groupNest it inside an existing stack, the way all the concretes share one slot.
Which groupThe creative tab is set to match automatically — a group only works in its own tab.
TagsLabels other things can look for. A pickaxe tagged ruby_tier can then be required by your ore before it drops anything.space separated — bare names get your namespace, minecraft: ones are vanilla

Item behaviour

Stack sizeHow many fit in one inventory slot. The pack asks for exactly the number you type here, but the game does not always honour it: 50 came back as 48 in testing. 1, 16 and 64 are the sizes vanilla itself uses and the ones that behave.whole number, 1 to 64
DurabilityHow much wear it takes before breaking. Most actions cost 1 point. An item with durability always sits alone in its slot, so this and stack size cannot both be on.whole number, 1 to 32767
Attack damageExtra damage on top of your bare fist when you hit something with this item. A netherite sword is 8.whole number, 0 to 255
Held like a toolAngles it in your hand the way a sword or pickaxe sits, instead of lying flat like an ingot.
Enchanted glintThe purple shimmer, always on, without any actual enchantment.
RarityColours the name in the tooltip, like an enchanted golden apple. Turning this on turns off the name colour below, since they fight over the same thing.
Name colourPicks the tooltip colour yourself instead of letting rarity choose it.
Animation when held downWhat the player does while you hold use. Eat or Drink is what makes the eating animation show in first person — the food settings on their own are not enough.
Allowed in off-handCan be put in the off-hand slot, like a shield or a totem.
Furnace fuelBurns in a furnace for this many seconds. Coal is 80.0.1 to 10000, 1 decimal place
Never despawnsDropped on the ground it stays there instead of vanishing after five minutes.
Right-click targets liquidsAims at the surface of water rather than the block underneath. This is how lily pads sit on water and how buckets fill.

Eating

EdibleMakes it eatable. Set the animation above to Eat as well, or nothing shows in first person.
Hunger restoredHalf-drumsticks refilled. Steak is 8.whole number, 0 to 20
Saturation modifierHow long the food holds hunger off afterwards. Steak is 0.8, bread is 0.6.0 to 20, 1 decimal place
Seconds to eatHow long you hold before it is swallowed. Most food is 1.6.0.1 to 10, 1 decimal place
Edible on a full hunger barCan be eaten any time, the way golden apples can.
Leaves behindWhat you are holding once it is eaten — the empty bowl from a stew, the bottle from a drink.

Block behaviour

Seconds to mineHow long it takes to break by hand. Stone is 1.5, obsidian is 50.0 to 1000, 1 decimal place
Mined faster byWithout one of these it takes the same time with any tool as with your fist. Shears and swords are documented as not working yet.
Explosion resistanceHow well it survives blasts. Stone is 6, obsidian is 1200.0 to 10000, 1 decimal place
Light emittedHow brightly it glows. A torch is 14, glowstone is 15.whole number, 0 to 15
Light blockedHow much light it stops passing through. 15 for a solid block, 0 for anything you can see through.whole number, 0 to 15
SoundWhat you hear walking on it and breaking it.
TransparencyWorked out from your texture unless you force it. Solid ignores transparency, cut-out gives hard edges like leaves, see-through allows partial fade like stained glass.
Colour on mapsThe colour this block shows as on a filled map.
Custom frictionodd resultsHow much grip you have on top of it. Normal ground is 0.6 — values near 0 or near 0.9 behaved strangely in testing, so stay close to the middle.0 to 0.9, 2 decimal places
Catches fireCan be set alight and burn away, like wood. It lights on its top face only — fire will not climb its sides the way it does on vanilla wood.both chances are whole numbers, 0 to 100
Catch chance
Burn chance

Extra behaviour

WearableCan be worn in an armour slot. The protection works, but it will be invisible on your character — that needs an armour model this tool does not build yet.protection is a whole number, 0 to 20
Which slot
Protection
RepairableWhich items mend it in an anvil, and how much durability each one gives back.space separated — durability restored is a whole number, 1 to 32767
Mended with
Durability back
EnchantableCan go on an enchanting table. Higher enchantability means better enchantments for the same levels — gold is 22, diamond is 10.whole number, 0 to 30
Which enchantments it can get
Enchantability
CompostableCan go in a composter, with this percent chance of raising the level.whole number, 0 to 100
Chance to raise the level
DyeableCan be dyed in a cauldron, tinting the texture the way leather armour does.
Colour before it is dyed
Has a cooldownGreys out for a while after use. Everything sharing a group cools down together, the way all ender pearls do at once — invent a name to give this item its own.seconds, 0.1 to 600, 1 decimal place
Cooldown group
Seconds
Is a crafting stationRight-click it to open a crafting grid of its own. The title is what appears at the top of that screen. The recipe tag is a name you invent to link recipes to this block — any recipe that ticks the same tag can only be crafted here.
Title shown on its screen
Recipe tag
How redstone sees this blockRedstone sorts every block into see-through or solid, and that single call decides both whether the block can carry power and whether dust can get down past it. Pick which one yours is — every block is one of these three, so there is no “off”.
A repeater or a powered block beside it lights this block up, and it hands that power on to any dust touching it. The trade is that it stops being see-through, so dust can no longer squeeze down past its sides and the tight zig-zag vertical ladders — the ones that have to be built out of glass or slabs — break through it. Ordinary diagonal stair-stepping is unaffected.
Redstone ignores the block. It never powers dust beside it, but wire runs freely up and down its sides, so vertical ladders and stair-steps both work through it. This is what a block does when nothing tells redstone otherwise.
Redstone can climb the block but never come back down it. Stair-steps and vertical ladders both carry a signal upwards and both kill it going down, and it powers no dust beside it either. Minecraft still draws wire as connected where nothing gets through, and unconnected where power does, so do not trust how it looks.
Measured in game rather than taken from documentation: solid behaves exactly like wool, see-through exactly like glass, one-way exactly like a slab.
Can be built overPlacing a block into its space destroys it instead of stacking against it, the way tall grass works.
Can go in a flower potPlaceable inside a flower pot.
Leads can be tied to itA lead can be knotted onto it, like a fence.

Extra components

Anything not covered aboveWritten straight into the components object. Two that used to have their own boxes: {"minecraft:interact_button": "Plant"} adds a labelled touch button, but only for items with a real entity interaction, and {"minecraft:can_destroy_in_creative": false} which behaved backwards in testing.

Drop rules

With no rules the block drops itself. Each rule becomes one pool, and pools are independent — several can fire from one break.

Ways to make it

Add as many as you like — one thing can have several recipes. Type ingredients as IDs like minecraft:stick, or start with # for a tag such as #minecraft:planks, which accepts any plank type and lets you mix them.

Sprite sheets

A sprite sheet is one image holding lots of small pictures in a grid. Upload one and it is cut into tiles you can send straight to new items and blocks, or onto something you have already made. Every texture slot also has a From sprites button that opens this picker where you are working.

Reference

Click any row to copy it. Everything here is read straight from the vanilla files, so the texture paths are the real ones.

Bulk actions

Ordinary fields are edited straight from the Properties, Texture, Drops and Recipes tabs — whatever you change there lands on everything selected. These are the wipe-and-copy jobs that don't fit that pattern.

Naming

Addon nameWhat the pack is called in Minecraft’s pack list, and what the downloaded file is named.
NamespaceA short name that keeps your things separate from everyone else’s. Your ruby becomes mypack:ruby. Pick one and stick with it — changing it later renames everything you have made.a-z, 0-9 and _
DescriptionThe grey line under the name in the pack list.
Pack iconThe picture beside your pack in the list. Optional.any image, resized to 128 × 128

Versions

Pack versionBump this before every rebuild. Import a pack twice at the same version and Minecraft rejects it as a duplicate; raise the number and it installs happily — but alongside the old one, not over it. Both then sit in your pack list, so putting the version in the addon name above makes them easy to tell apart.three numbers, like 1.0.0
Minimum game versionThis one stays on the old 1.x numbering even though Bedrock releases are named 26.x now. Put 26.40.0 here and the addon is rejected the moment you open it, before any log is written. Leave it at 1.21.0 unless you know otherwise.three numbers, must start with 1
Item and block formatWhich version of the file layout your items and blocks are written in. It keeps its own leading 1., so it looking different from the two above is normal.
Recipe formatThe same idea for recipe files, which move at their own pace.

Pack IDs

Every addon needs four IDs that belong to it alone. These are saved in your project file, so every rebuild stays recognisably the same addon. They do not make a new build replace an older one — nothing does. Only generate new IDs if you are splitting this into a genuinely separate addon.

Downloads

The .mcaddon holds both halves of your addon in one file — open it and Minecraft imports both. The two separate downloads are only useful if you are placing the files somewhere by hand.

Installing

  1. Open the .mcaddon. Minecraft imports both packs.
  2. In your world's settings, activate the behaviour pack — the resource pack follows automatically.
  3. Turn on Settings › Creator › Content Log GUI before testing. It names the exact file when something fails to parse.
  4. Rebuilding later? Bump the pack version first, or the import is refused as a duplicate. The new build installs next to the old one rather than replacing it, so go into each world you want updated and swap it over there, then delete the old one under Settings › Storage.
  5. To hand yourself everything at once, run /function give_all in game. Each item and block also gets its own function named after its identifier.

Checks

Console compatibility

Pick a sprite

Name

Too long for console

Welcome to Addon Studio. It turns what you make here into a Minecraft addon you can open straight into the game. First time? The tutorial walks you through building one.