Namespaces and identifiers

How to name your items, blocks and mobs so they never collide with the game or other add-ons.

The shape of an identifier

Every item, block and entity has an identifier written namespace:name, for example minecraft:diamond_sword. Vanilla content uses the namespace minecraft.

Pick your own namespace

Use a short prefix that is yours, such as your initials or the add-on name: ab:ruby_sword. Keep it lowercase, with letters, digits and underscores. Do not use minecraft for new things: that namespace is for the game, and using it for a new identifier can break when the game adds something with the same name.

When you do use minecraft:

Only to change something that already exists. A file in your behavior pack with the identifier minecraft:zombie replaces the vanilla zombie definition.

One identifier, one file

Two files that define the same identifier are an error: the game loads one and reports the other. The add-on file checker finds duplicates inside a file, and the maker warns you while you edit.

Where to find vanilla identifiers

The Bedrock ID list has every item, block, entity, effect, enchantment and biome identifier of the current version.

More guides

More from 9Minecraft