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": "wiki:my_block",
"properties": {
"wiki:string_property_example": [
"red",
"green",
"blue",
"purple"
],
"wiki:boolean_property_example": [true, false],
"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
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
Using Properties:
Properties can be queried with query.block_property, like this:
query.block_property('wiki:string_property_example') == 'blue'
Block Events
Copy
{
"format_version": "1.16.100",
"minecraft:block": {
"description": {
"identifier": "wiki:my_block"
},
"components": {
"minecraft:on_step_on": {
"event": "wiki:drop_loot",
"target": "self"
}
},
"events": {
"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 when triggered
Copy
{
"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 mob effect when triggered
Copy
{
"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 when the event is triggered.
Copy
{
"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
{
"wiki:place_block": {
"set_block": "minecraft:grass"
}
}
1
2
3
4
5
2
3
4
5
set_block_property
Used to set the value of a block's property
Copy
{
"wiki:change_color": {
"set_block_property": {
"wiki:string_property_example": "red"
}
}
}
1
2
3
4
5
6
7
2
3
4
5
6
7
set_block_at_pos
Used to set a block relative to the position of this block
Copy
{
"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
Used to execute a command
Copy
{
"wiki:execute_event": {
"run_command": {
"command": ["summon pig"]
}
}
}
1
2
3
4
5
6
7
2
3
4
5
6
7
damage
Copy
{
"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 stack
Copy
{
"wiki:remove_one": {
"decrement_stack": {}
}
}
1
2
3
4
5
2
3
4
5
die
Kills the target or destroys the block
Copy
{
"wiki:destroy": {
"die": {
"target": "self"
}
}
}
1
2
3
4
5
6
7
2
3
4
5
6
7
play_effect
Runs a particle effect on the target
Copy
{
"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
Plays a sound on the target
Copy
{
"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
Used to trigger an event, this can be a block event or an entity event.
Copy
{
"wiki:trigger_event": {
"trigger": {
"event": "wiki:my_event",
"target": "self" // If set to 'other' an entity event can be defined. It will be triggered on the entity that causes the block event.
}
}
}
1
2
3
4
5
6
7
8
2
3
4
5
6
7
8
sequence
Used to sequence event functions
Copy
{
"wiki:sequence_event": {
"sequence": [
{
"set_block_property": {
"wiki:my_prop": true
}
},
{
"condition": "query.block_property('wiki:my_prop') == true",
"trigger": {
"event": "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
Used to randomize event functions
Copy
{
"wiki:randomize_events": {
"randomize": [
{
"weight": 1,
"set_block_property": {
"wiki:boolean_property_example": false
}
},
{
"weight": 2,
"set_block_property": {
"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 components to trigger block events:
minecraft:on_interactminecraft:on_step_onminecraft:on_step_offminecraft:on_fall_onminecraft:on_placedminecraft:on_player_placingminecraft:on_player_destroyedminecraft:tickingandminecraft:random_tickingcan both be used to trigger events after a set amount of time or at random times, depending on which component you use
Block Components
List of all new block components, with usage examples.
minecraft:breathability
Copy
{
"minecraft:breathability": "solid" // Also accepts 'air'
}
1
2
3
2
3
minecraft:display_name
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
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('wiki:example_property') == 0", //also accepts `q.has_block_property`
"bone_2": "q.block_property('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
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('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('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('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('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('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('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('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('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('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": "wiki:my_block"
},
"components": {
"tag: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": "wiki:pickaxe"
},
"components": {
"minecraft:digger": {
"use_efficiency": true,
"destroy_speeds": [
{
"block": {
"tags": "query.any_tag('wiki:my_tag', 'stone', 'metal')"
},
"speed": 6
}
]
}
}
}
}
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.
wiki:
Copy
{
"format_version": "1.16.100",
"minecraft:block": {
"description": {
"identifier": "wiki:my_block",
"properties": {
"wiki:custom_integer_property": [ 10, 20, 30, 40 ],
"wiki:custom_boolean_property": [ false, true ],
"wiki:custom_string_property": [ "red", "green", "blue" ]
}
},
"components": {...},
"permutations": [
{
"condition": "query.block_property('wiki:custom_integer_property') == 20",
"components": {
"minecraft:friction": 0.1
}
},
{
"condition": "query.block_property('wiki:custom_boolean_property') == true",
"components": {
"minecraft:destroy_time": 0.5
}
},
{
"condition": "query.block_property('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 hardcoded. 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. Example:
Copy
{
"minecraft:display_name": "Barrel of Foxes"
}
1
2
3
2
3
In-game, yields the result: tile.Barrel of Foxes.name. Using .lang files is recommended.
- Maximum of 16 values per
property. - Following components cannot be larger than 16x16x16:
minecraft:entity_collisionminecraft:pick_collision
/executecommands cannot be run on blocks.- Custom blocks' tags are ignored by vanilla items.
- Block faces will become dark if buried in another block.
- Blocks will always be dropped with
Silk Touchenchantment. - Block identifiers cannot match vanilla blocks, even ignoring namespace.
- Following components requires
entity_collisionto be 4 or higher on the y-axis:minecraft:on_step_onminecraft:on_step_offminecraft:on_fall_on
- It seems that
render_methodinminecraft:material_instancesaffects the block's properties.- If you use
opaqueit will allow redstone to pass through it, grass decay, and allow mobs to spawn on it - If you use
alpha_testit won't allow redstone to pass through it, it won't make grass decay, and it won't allow mobs to spawn on it blendhas the same properties asalpha_test- Should you want to have a transparent block but have
opaqueproperties:
- If you use
"minecraft:material_instances": {
"*": {
"render_method": "alpha_test"
}
}
1
2
3
4
5
2
3
4
5
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.