Blocks 1.16.100+
experimental
Better documentation on the new block format introduced in the Minecraft Beta 1.16.100.
WARNING
This document covers experimental features, for 1.16.100+ format version blocks. If you would like to learn about stable blocks, you can do it here.
Block Properties
Defining Properties:
Copy
{
"format_version": "1.16.100",
"minecraft:block": {
"description": {
"identifier": "bedrock_wiki:exemplary_block",
"properties": {
"bedrock_wiki:string_property_example": [
"red",
"green",
"blue",
"purple"
],
"bedrock_wiki:boolean_property_example": [
true, false
],
"bedrock_wiki:integer_property_example": [
1, 2, 3, 4, 5
]
}
}
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
Using Properties:
Properties can be tested for with the Molang query, query.block_property:
query.block_property('bedrock_wiki:string_property_example') == 'blue'
Block Events
Copy
{
"format_version": "1.16.100",
"minecraft:block": {
"description": {
"identifier": "bedrock_wiki:exemplary_block"
},
"components": {
"minecraft:on_step_on": {
"event": "bedrock_wiki:drop_loot",
"target": "self"
}
},
"events": {
"bedrock_wiki:drop_loot": {
"spawn_loot": {
"table": "loot_tables/blocks/my_loot_table.json"
}
}
}
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
This example spawns a loot table when an entity stands on the block.
Event Functions
add_mob_effect
Adds a mob effect to a target when triggered.
Copy
{
"bedrock_wiki:effect_event": {
"add_mob_effect": {
"effect": "poison",
"target": "other",
"duration": 8,
"amplifier": 3
}
}
}
1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
remove_mob_effect
Removes a target's mob effect when triggered.
Copy
{
"bedrock_wiki:remove_effect_event": {
"remove_mob_effect": {
"effect": "poison",
"target": "other"
}
}
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
spawn_loot
Summons a loot table.
Copy
{
"bedrock_wiki:drop_loot": {
"spawn_loot": {
"table": "loot_tables/blocks/my_loot_table.json"
}
}
}
1
2
3
4
5
6
7
2
3
4
5
6
7
set_block
Removes the current block and replaces it with the defined block in the same position.
Copy
{
"bedrock_wiki:place_block": {
"set_block": "minecraft:grass"
}
}
1
2
3
4
5
2
3
4
5
set_block_property
Sets the block's property.
Copy
{
"bedrock_wiki:change_color": {
"set_block_property": {
"bedrock_wiki:string_property_example": "red"
}
}
}
1
2
3
4
5
6
7
2
3
4
5
6
7
set_block_at_pos
Sets a block at a specified position relative to the block.
Copy
{
"bedrock_wiki:trigger_event": {
"set_block_at_pos": {
"block_type": "minecraft:stone",
"block_offset": [0, 0, 0]
}
}
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
run_command
Runs a command onto a target in context.
Copy
{
"bedrock_wiki:execute_event": {
"run_command": {
"target": "self",
"command": [ "summon pig" ]
}
}
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
damage
Inflicts a specified damage unto a target in context.
Copy
{
"bedrock_wiki:damage_event": {
"damage": {
"type": "magic",
"target": "other",
"amount": 4
}
}
}
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
decrement_stack
Decrements the player's current item stack.
Copy
{
"bedrock_wiki:remove_one": {
"decrement_stack": {}
}
}
1
2
3
4
5
2
3
4
5
die
Kills the specified target in context (Destroying the block, if specified).
Copy
{
"bedrock_wiki:destroy": {
"die": {
"target": "self"
}
}
}
1
2
3
4
5
6
7
2
3
4
5
6
7
play_effect
Play a particle effect at a specified contextual target's position.
Copy
{
"bedrock_wiki:particle_effect": {
"play_effect": {
"effect": "minecraft:campfire_smoke",
"target": "self"
}
}
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
play_sound
Play a sound to a specified contextual target.
Copy
{
"bedrock_wiki:play_sound": {
"play_sound": {
"sound": "mob.enderman.death",
"target": "self"
}
}
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
trigger
Triggers an event unto a specified contextual target.
Copy
{
"bedrock_wiki:trigger_event": {
"trigger": {
"event": "bedrock_wiki:my_event",
"target": "self"
}
}
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
sequence
Sequences event functions
Copy
{
"bedrock_wiki:sequence_event": {
"sequence": [
{
"set_block_property": {
"bedrock_wiki:my_prop": true
}
},
{
"condition": "query.block_property('bedrock_wiki:my_prop') == true",
"trigger": {
"event": "bedrock_wiki:my_entity_event",
"target": "other"
}
}
]
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
randomize
Randomizes event functions
Copy
{
"bedrock_wiki:randomize_events": {
"randomize": [
{
"weight": 1,
"set_block_property": {
"bedrock_wiki:boolean_property_example": false
}
},
{
"weight": 2,
"set_block_property": {
"bedrock_wiki:boolean_property_example": true
}
},
{
"weight": 4,
"set_block": "minecraft:stone"
}
]
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
Triggering Events
Block event-trigger components:
minecraft:on_interactminecraft:on_step_onminecraft:on_step_offminecraft:on_fall_onminecraft:on_placedminecraft:on_player_placingminecraft:on_player_destroyedminecraft:tickingandminecraft:random_tickingmay be used to trigger events after a time either set or random, respectively
Block Components
List of experimental block components, with usage examples.
minecraft:breathability
Copy
{
"minecraft:breathability": "solid" // Also accepts 'air'
}
1
2
3
2
3
minecraft:display_name
(See the Additional Notes at the bottom of this page)
Copy
{
"minecraft:display_name": "Name"
}
1
2
3
2
3
minecraft:entity_collision
Copy
{
"minecraft:entity_collision": {
"origin": [ -8, 0, -8 ],
"size": [ 16, 16, 16 ]
}
}
1
2
3
4
5
6
2
3
4
5
6
Or..
Copy
{
"minecraft:entity_collision": false
}
1
2
3
2
3
minecraft:geometry
Copy
{
"minecraft:geometry": "geometry.wiki" // Geometry identifier from geo file in 'RP/models/entity' folder
}
1
2
3
2
3
minecraft:material_instances
Copy
{
"minecraft:material_instances": {
// Can also be a specific material instance for a specific face mapped in the geometry
// Wildcards follow render controller syntax
// Options 'up', 'down', and 'sides' are builtin
"*": {
"texture": "texture_name", // References texture defined in terrain_textures.json
"render_method": "blend", // Options 'blend', 'opaque', 'alpha_test',
"face_dimming": true, // Defaults to true; refers to whether or not block is affected by lighting (Undocumented)
"ambient_occlusion": true // Defaults to true; refers to whether or not faces have smooth lighting (Undocumented)
}
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
2
3
4
5
6
7
8
9
10
11
12
13
minecraft:part_visibility
Copy
{
"minecraft:part_visibility": {
"rules": {
"bone_1": "q.block_property('bedrock_wiki:example_property') == 0", //also accepts `q.has_block_property`
"bone_2": "q.block_property('bedrock_wiki:example_property') == 0"
}
}
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
minecraft:pick_collision
Copy
{
"minecraft:pick_collision": {
"origin": [ -8, 0, -8 ],
"size": [ 16, 16, 16 ]
}
}
1
2
3
4
5
6
2
3
4
5
6
Or..
Copy
{
"minecraft:pick_collision": false
}
1
2
3
2
3
minecraft:placement_filter
Copy
{
"minecraft:placement_filter": {
"conditions": [
{
"block_filter": [ "minecraft:dirt" ],
"allowed_faces": [ "up" ]
}
]
}
}
1
2
3
4
5
6
7
8
9
10
2
3
4
5
6
7
8
9
10
This also accepts tags, such as:
Copy
{
"minecraft:placement_filter": {
"conditions": [
{
"allowed_faces": [ "up" ],
"block_filter": [
{
"tags": "!query.any_tag('stone')"
}
]
}
]
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
2
3
4
5
6
7
8
9
10
11
12
13
14
See this page for a list of vanilla tags and relavent blocks.
minecraft:random_ticking
Copy
{
"minecraft:random_ticking": {
"on_tick": {
"event": "block_event",
"target": "self",
"condition": "query.block_property('bedrock_wiki:block_property') == true"
}
}
}
1
2
3
4
5
6
7
8
9
2
3
4
5
6
7
8
9
minecraft:rotation
Copy
{
"minecraft:rotation": [ 90, 180, 0 ]
}
1
2
3
2
3
minecraft:ticking
Copy
{
"minecraft:ticking": {
"looping": true,
"range": [4, 4],
"on_tick": {
"event": "block_event",
"target": "self",
"condition": "query.block_property('bedrock_wiki:block_property') == true"
}
}
}
1
2
3
4
5
6
7
8
9
10
11
2
3
4
5
6
7
8
9
10
11
minecraft:unit_cube
Copy
{
"minecraft:unit_cube": {}
}
1
2
3
2
3
minecraft:unwalkable
Copy
{
"minecraft:unwalkable": true
}
1
2
3
2
3
minecraft:crafting_table
Copy
{
"minecraft:crafting_table": {
"custom_description": "Example Crafting Table", // Name shown in GUI
"grid_size": 3, // Currently only supports 3
"crafting_tags": ["crafting_table", "custom_crafting_tag"]
}
}
1
2
3
4
5
6
7
2
3
4
5
6
7
minecraft:on_step_on
Copy
{
"minecraft:on_step_on": {
"event": "block_event",
"target": "self",
"condition": "query.block_property('bedrock_wiki:block_property') == true"
}
}
1
2
3
4
5
6
7
2
3
4
5
6
7
minecraft:on_step_off
Copy
{
"minecraft:on_step_off": {
"event": "block_event",
"target": "self",
"condition": "query.block_property('bedrock_wiki:block_property') == true"
}
}
1
2
3
4
5
6
7
2
3
4
5
6
7
minecraft:on_fall_on
Copy
{
"minecraft:on_fall_on": {
"event": "block_event",
"target": "self",
"condition": "query.block_property('bedrock_wiki:block_property') == true",
"min_fall_distance": 5
}
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
minecraft:on_placed
Copy
{
"minecraft:on_placed": {
"event": "block_event",
"target": "self",
"condition": "query.block_property('bedrock_wiki:block_property') == true"
}
}
1
2
3
4
5
6
7
2
3
4
5
6
7
minecraft:on_player_placing
Copy
{
"minecraft:on_player_placing": {
"event": "block_event",
"target": "self",
"condition": "query.block_property('bedrock_wiki:block_property') == true"
}
}
1
2
3
4
5
6
7
2
3
4
5
6
7
minecraft:on_player_destroyed
Copy
{
"minecraft:on_player_destroyed": {
"event": "block_event",
"target": "self",
"condition": "query.block_property('bedrock_wiki:block_property') == true"
}
}
1
2
3
4
5
6
7
2
3
4
5
6
7
minecraft:on_interact
Copy
{
"minecraft:on_interact": {
"event": "block_event",
"target": "self",
"condition": "query.block_property('bedrock_wiki:block_property') == true"
}
}
1
2
3
4
5
6
7
2
3
4
5
6
7
Block Tags
Block tags can be given to blocks to be queried or referenced with any_tag or all_tags, which is used inside item and entity files. A tag can be applied like this:
Copy
{
"format_version": "1.16.100",
"minecraft:block": {
"description": {
"identifier": "bedrock_wiki:exemplary_block"
},
"components": {
"tag:bedrock_wiki:my_tag": {},
"tag:my_other_tag": {}
}
}
}
1
2
3
4
5
6
7
8
9
10
11
12
2
3
4
5
6
7
8
9
10
11
12
and this tag can be queried with:
query.all_tagsquery.any_tagquery.block_has_all_tagsquery.block_has_any_tagquery.relative_block_has_all_tagsquery.relative_block_has_any_tag
Example of querying a tag:
Copy
{
"format_version": "1.16.100",
"minecraft:item": {
"description": {
"category": "equipment",
"identifier": "bedrock_wiki:pickaxe"
},
"components": {
"minecraft:digger": {
"use_efficiency": true,
"destroy_speeds": [
{
"speed": 5
"block": {
"tags": "query.any_tag('bedrock_wiki:my_tag', 'stone', 'metal')"
}
}
]
}
}
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
Block Permutations
Block permutations are a way of conditionally applying components to a block with Molang expressions.
bedrock_wiki:
Copy
{
"format_version": "1.16.100",
"minecraft:block": {
"description": {
"identifier": "bedrock_wiki:exemplary_block",
"properties": {
"bedrock_wiki:custom_integer_property": [ 10, 20, 30, 40 ],
"bedrock_wiki:custom_boolean_property": [ false, true ],
"bedrock_wiki:custom_string_property": [ "red", "green", "blue" ]
}
},
"components": {...},
"permutations": [
{
"condition": "query.block_property('bedrock_wiki:custom_integer_property') == 20",
"components": {
"minecraft:friction": 0.1
}
},
{
"condition": "query.block_property('bedrock_wiki:custom_boolean_property') == true",
"components": {
"minecraft:destroy_time": 0.5
}
},
{
"condition": "query.block_property('bedrock_wiki:custom_string_property') == 'red'",
"components": {
"minecraft:geometry": "geometry.pig"
}
}
]
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
Additional Notes
- Vanilla blocks are hard-coded. You may not override or access them.
- Following components may only have one at any given time:
"minecraft:ticking""minecraft:random_ticking"
- It is not recommended to use
minecraft:display_name. As an example..
Copy
{
"minecraft:display_name": "Barrel of Foxes"
}
1
2
3
2
3
.. Will, in-game, yield the result: tile.Barrel of Foxes.name. Using language files is strongly recommended.
- A maximum of
16values per block property may be used. - The following components may not exceed the default (16x) block size limitations:
minecraft:entity_collisionminecraft:pick_collision
- Custom blocks' tags are ignored by Vanilla items.
- Block faces will unconditionally darken if intersecting another block.
- Blocks will always be dropped when mined with the
Silk Touchenchantment. - The following event triggers require
entity_collisionto be 4 or higher on the Y-axis:minecraft:on_step_onminecraft:on_step_offminecraft:on_fall_on
- Different parameters for
render_methodinminecraft:material_instanceswill - similar to entity runtime identifiers - affect certain properties of the block:- Inputting
opaquewill allow Redstone to pass through, Grass to decay, and on it, Mobs' spawning - Inputting
alpha_testwill not allow Redstone to pass through, Grass to decay, or Mobs to spawn on itblendhas the same properties asalpha_test
- Creating a transparent block exhibiting
opaqueproperties:
- Inputting
Use alpha_test
"minecraft:material_instances": {
"*": {
"render_method": "alpha_test"
}
}
1
2
3
4
5
2
3
4
5
..Then simply link the textures via blocks.json
Contributors
We use cookies to improve your experience. By continuing to use this site, you agree to our use of cookies. See our Privacy Policy for more information.