Intro to Blocks
FORMAT & MIN ENGINE VERSION 1.21.40
This page discusses basic block features. You can learn more about other block components here.
NOTE
Vanilla blocks are hardcoded. You may not override or access them.
Minecraft Bedrock allows us to add custom blocks into our world with various vanilla-like properties. Custom blocks can have multiple stages (like plants), directional facing, and other useful features.
This tutorial will cover how to create basic blocks for the stable version of Minecraft.
Registering Blocks
Block definitions are structured similarly to entities: they contain a description and a list of components that defines the block's behavior.
Unlike entities, blocks do not have a resource definition other than in RP/blocks.json.
Below is the minimum behavior-side code to get a custom block into the creative inventory.
{
"format_version": "1.21.40",
"minecraft:block": {
"description": {
"identifier": "wiki:custom_block",
"menu_category": {
"category": "construction", // The creative inventory or recipe book tab that the block is placed into
"group": "itemGroup.name.concrete", // The expandable group that the block is a part of. (Optional)
"is_hidden_in_commands": false // Is the block hidden from use in commands? (Optional)
}
},
"components": {} // Must be here, even if empty!
}
}Block Description
- Defines the block's
identifier- a unique ID in the format ofnamespace:identifier. - Configures which
menu_categorythe block is placed into.- Also takes the optional parameters
groupandis_hidden_in_commands.
- Also takes the optional parameters
The block description is also home to states and traits, which are covered in their own pages.
Adding Components
Right now, our custom block is using the default component values (which can be found here).
Let's configure our own functionality!
{
"format_version": "1.21.40",
"minecraft:block": {
"description": {
"identifier": "wiki:custom_block",
"menu_category": {
"category": "construction"
}
},
"components": {
"minecraft:destructible_by_mining": {
"seconds_to_destroy": 3
},
"minecraft:destructible_by_explosion": {
"explosion_resistance": 3
},
"minecraft:friction": 0.4,
"minecraft:map_color": "#ffffff",
"minecraft:light_dampening": 0,
"minecraft:light_emission": 4,
"minecraft:loot": "loot_tables/blocks/custom_block.json"
}
}
}minecraft:destructible_by_miningdefines how long the player will need to mine the block until it breaks. Currently, it isn't possible to set different destroy times for different tools.minecraft:destructible_by_explosiondefines the resistance to explosions. The higher the value, the lower the chance of destruction.minecraft:frictiondefines how much friction the block has. For example, soul sand has a high value for friction, so it slows the players. Ice has a lower friction value, so it has a slippery effect. The friction of classic blocks such as wood or stone is0.4.minecraft:map_coloris the hex color code that will be displayed on a Minecraft map to represent this block.#ffffffmeans white. You can get hex codes for other colors here.minecraft:light_dampeningdefines how much light will be blocked from passing through.minecraft:light_emissiondefines the light level the block will output.minecraft:lootdefines a loot table path for the block to drop. If this is removed, then the block will drop itself. You can learn more about loot tables here.
Browse more block components here!
Applying Textures
WARNING
RP/blocks.json ignores identifier namespaces. You can put anything there or not include a namespace at all, resulting in no difference. This may cause problems if you create a custom block with the same name (but not namespace) as an existing vanilla block.
Block sounds can also be defined within RP/blocks.json.
For our basic 16×16×16 pixel block, textures should be defined in RP/blocks.json.
If you'd like to apply a custom model, the geometry and material instances components should be used instead.
{
"format_version": "1.21.40",
"wiki:custom_block": {
"textures": "custom_block", // This texture shortname should be defined in `terrain_texture.json`, as shown below
"sound": "grass"
}
}Now, we need to link the texture shortname to an image file path in RP/textures/terrain_texture.json:
{
"texture_name": "atlas.terrain",
"resource_pack_name": "wiki", // ID for your resource pack
"padding": 8, // Prevent textures from visually overflowing into each other
"num_mip_levels": 4, // Quality of texture when viewed from a distance or at an angle
"texture_data": {
// Our texture shortname:
"custom_block": {
"textures": "textures/blocks/custom_block" // Link to an image file name
}
}
}Per-Face Textures
Textures can also be applied per face. For example, a custom "compass block" could use the following ✨stunning✨ textures:
textures/blocks/compass_block_down.png
textures/blocks/compass_block_up.png
textures/blocks/compass_block_north.png
textures/blocks/compass_block_east.png
textures/blocks/compass_block_south.png
textures/blocks/compass_block_west.png
The blocks.json entry would look like this:
{
"format_version": "1.21.40",
"wiki:compass_block": {
"textures": {
"down": "compass_block_down",
"up": "compass_block_up",
"north": "compass_block_north",
"east": "compass_block_east",
"south": "compass_block_south",
"west": "compass_block_west"
}
}
}Or, if you're using material instances, they should look like this:
"minecraft:material_instances": {
"*": {
"texture": "compass_block_down" // This texture appears in destruction particles
},
"up": {
"texture": "compass_block_up"
},
"north": {
"texture": "compass_block_north"
},
"east": {
"texture": "compass_block_east"
},
"south": {
"texture": "compass_block_south"
},
"west": {
"texture": "compass_block_west"
}
}With the following terrain_texture.json data:
{
"texture_name": "atlas.terrain",
"resource_pack_name": "wiki",
"padding": 8,
"num_mip_levels": 4,
"texture_data": {
"compass_block_down": {
"textures": "textures/blocks/compass_block_down"
},
"compass_block_up": {
"textures": "textures/blocks/compass_block_up"
},
"compass_block_north": {
"textures": "textures/blocks/compass_block_north"
},
"compass_block_east": {
"textures": "textures/blocks/compass_block_east"
},
"compass_block_west": {
"textures": "textures/blocks/compass_block_west"
},
"compass_block_south": {
"textures": "textures/blocks/compass_block_south"
}
}
}Defining Names
Finally, let's define our block names like this:
tile.wiki:custom_block.name=Custom Block
tile.wiki:compass_block.name=Compass BlockYou can learn more about translation here.
Result
In this page, you've learnt about the following:
...but it's only the beginning, see what else you could do below!
What's Next?
Add Functionality
Learn about the available block components to craft unique gameplay.
Why not give your block a custom model with the geometry component? You could also configure your own collision and selection boxes to match!
Create Variants
Make use of block states and permutations to conditionally enable components on your blocks.
For example, you could add liquid depth levels to your custom tank block, with support for multiple liquid types.
Replicate Vanilla
Browse several complete replicas of existing blocks in the Vanilla Re-Creations category.
Start simple with custom glass blocks, making use of material instances!