Block Components Documentation - minecraft:material_instances

The material instances for a block. Maps face or material_instance names in a geometry file to an actual material instance. You can assign a material instance object to any of these faces: "up", "down", "north", "south", "east", "west", or "*". You can also give an instance the name of your choosing such as "my_instance", and then assign it to a face by doing "north":"my_instance".

Note

From 1.21.80 onward, when using a minecraft:geometry component or minecraft:material_instances component, you must include both.

Material Instances Properties

Name	Default Value	Type	Description	Example Values
*	not set	* item		Block Fabricator: {"texture":"mikeamm_gwve_fabricator","render_method":"alpha_test","ambient_occlusion":1}, Block Gray Ore: {"texture":"mikeamm_gwve_gray_ore","render_method":"alpha_test","face_dimming":false}, Block Frond Top: {"texture":"frond_top","render_method":"alpha_test"}
down	not set	Down item
east	not set	East item
Material Instance	not set	Array of Material Instance items	A material instance definition to map to a material instance in a geometry file. The material instance "*" will be used for any materials that don't have a match.
north	not set	North item		Tuna Roll: "sushi_side"
south	not set	South item		Tuna Roll: "sushi_side"
up	not set	Up item
west	not set	West item

* item type

* Properties

Name	Default Value	Type	Description	Example Values
ambient_occlusion	not set	Decimal number		Block Fabricator: 1
render_method	not set	String		Block Fabricator: "alpha_test"
texture	not set	String		Block Fabricator: "mikeamm_gwve_fabricator"

Down item type

* Properties

Name	Default Value	Type	Description	Example Values
ambient_occlusion	not set	Decimal number	If this material has ambient occlusion applied when lighting, shadows will be created around and underneath the block. Decimal value controls exponent applied to a value after lighting.
face_dimming	not set	String	This material should be dimmed by the direction it's facing.	Blue Bubble Fish: true
isotropic	false	Boolean true/false	Should the faces that this material is applied to randomize their UVs? This item requires a format version of at least undefined.
render_method	not set	Render Method choices	The render method to use.	Blue Bubble Fish: "blend", Block Orange Ore: "opaque", Block Frond Top: "alpha_test"
texture	not set	String	Texture name for the material.	Blue Bubble Fish: "bubble_fish_blue", California Roll: "sushi_wrap", Green Bubble Fish: "bubble_fish_green"
tint_method	false	Boolean true/false	Tint multiplied to the color. Tint method logic varies, but often refers to the "rain" and "temperature" of the biome the block is placed in to compute the tint. Supported tint methods are "none", "default_foliage", "birch_foliage", "evergreen_foliage", "dry_foliage", "grass" and "water" This item requires a format version of at least undefined.

Render Method choices

Value	Title	Description
opaque	Opaque	Used for a regular block texture without an alpha layer. Does not allow for transparency or translucency
double_sided	Double Sided	Used for completely disabling backface culling.
blend	Blend	Used for a block like stained glass. Allows for transparency and translucency (slightly transparent textures).
alpha_test	Alpha Test	Used for a block like the monster spawner. Does not allow for translucency, only fully opaque or fully transparent textures. Also disabled backface culling.
alpha_test_single_sided	Alpha Test (Single Sided)	Used for a block like the (unstained) glass. Does not allow for translucency, only fully opaque or fully transparent textures. Also enables backface culling.
blend_to_opaque	Blend to Opaque	Will blend like stained glass in the near render and turn opaque on the far render.
alpha_test_to_opaque	Alpha Test to Opaque	Used for a block like the leaves. Does not allow for translucency, only fully opaque or fully transparent textures in the near render and turn only opaque on the far render. Also disabled backface culling.
alpha_test_single_sided_to_opaque	Alpha Test (Single Sided) to Opaque	Used for a block like the sugar cane. Does not allow for translucency, only fully opaque or fully transparent textures in the near render and turn only opaque on the far render. Also enables backface culling.

East item type

* Properties

Name	Default Value	Type	Description	Example Values
ambient_occlusion	not set	Decimal number	If this material has ambient occlusion applied when lighting, shadows will be created around and underneath the block. Decimal value controls exponent applied to a value after lighting.
face_dimming	not set	String	This material should be dimmed by the direction it's facing.	Blue Bubble Fish: true
isotropic	false	Boolean true/false	Should the faces that this material is applied to randomize their UVs? This item requires a format version of at least undefined.
render_method	not set	Render Method choices	The render method to use.	Blue Bubble Fish: "blend", Block Orange Ore: "opaque", Block Frond Top: "alpha_test"
texture	not set	String	Texture name for the material.	Blue Bubble Fish: "bubble_fish_blue", California Roll: "sushi_wrap", Green Bubble Fish: "bubble_fish_green"
tint_method	false	Boolean true/false	Tint multiplied to the color. Tint method logic varies, but often refers to the "rain" and "temperature" of the biome the block is placed in to compute the tint. Supported tint methods are "none", "default_foliage", "birch_foliage", "evergreen_foliage", "dry_foliage", "grass" and "water" This item requires a format version of at least undefined.

Render Method choices

Value	Title	Description
opaque	Opaque	Used for a regular block texture without an alpha layer. Does not allow for transparency or translucency
double_sided	Double Sided	Used for completely disabling backface culling.
blend	Blend	Used for a block like stained glass. Allows for transparency and translucency (slightly transparent textures).
alpha_test	Alpha Test	Used for a block like the monster spawner. Does not allow for translucency, only fully opaque or fully transparent textures. Also disabled backface culling.
alpha_test_single_sided	Alpha Test (Single Sided)	Used for a block like the (unstained) glass. Does not allow for translucency, only fully opaque or fully transparent textures. Also enables backface culling.
blend_to_opaque	Blend to Opaque	Will blend like stained glass in the near render and turn opaque on the far render.
alpha_test_to_opaque	Alpha Test to Opaque	Used for a block like the leaves. Does not allow for translucency, only fully opaque or fully transparent textures in the near render and turn only opaque on the far render. Also disabled backface culling.
alpha_test_single_sided_to_opaque	Alpha Test (Single Sided) to Opaque	Used for a block like the sugar cane. Does not allow for translucency, only fully opaque or fully transparent textures in the near render and turn only opaque on the far render. Also enables backface culling.

Material Instance item type

A material instance definition to map to a material instance in a geometry file. The material instance "*" will be used for any materials that don't have a match.

Material Instance Properties

Name	Default Value	Type	Description	Example Values
ambient_occlusion	not set	Decimal number	Should this material have ambient occlusion applied when lighting? If true, shadows will be created around and underneath the block. Optionally can be constructed with float to control exponent applied to ao value after lighting.
face_dimming	true	Boolean true/false	Should this material be dimmed by the direction it's facing?
isotropic	false	Boolean true/false	Should the faces that this material is applied to randomize their UVs?
render_method	opaque	String	The render method to use. Must be one of these options: "opaque" - Used for a regular block texture without an alpha layer. Does not allow for transparency or translucency. "double_sided" - Used for completely disabling backface culling. "blend" - Used for a block like stained glass. Allows for transparency and translucency (slightly transparent textures). "alpha_test" - Used for a block like the vanilla (unstained) glass. Does not allow for translucency, only fully opaque or fully transparent textures. Also disables backface culling.
texture	not set	String	Texture name for the material.
tint_method	false	Boolean true/false	Tint multiplied to the color. Tint method logic varies, but often refers to the "rain" and "temperature" of the biome the block is placed in to compute the tint. Supported tint methods are "none", "default_foliage", "birch_foliage", "evergreen_foliage", "dry_foliage", "grass" and "water"

North item type

* Properties

Name	Default Value	Type	Description	Example Values
ambient_occlusion	not set	Decimal number	If this material has ambient occlusion applied when lighting, shadows will be created around and underneath the block. Decimal value controls exponent applied to a value after lighting.
face_dimming	not set	String	This material should be dimmed by the direction it's facing.	Blue Bubble Fish: true
isotropic	false	Boolean true/false	Should the faces that this material is applied to randomize their UVs? This item requires a format version of at least undefined.
render_method	not set	Render Method choices	The render method to use.	Blue Bubble Fish: "blend", Block Orange Ore: "opaque", Block Frond Top: "alpha_test"
texture	not set	String	Texture name for the material.	Blue Bubble Fish: "bubble_fish_blue", California Roll: "sushi_wrap", Green Bubble Fish: "bubble_fish_green"
tint_method	false	Boolean true/false	Tint multiplied to the color. Tint method logic varies, but often refers to the "rain" and "temperature" of the biome the block is placed in to compute the tint. Supported tint methods are "none", "default_foliage", "birch_foliage", "evergreen_foliage", "dry_foliage", "grass" and "water" This item requires a format version of at least undefined.

Render Method choices

Value	Title	Description
opaque	Opaque	Used for a regular block texture without an alpha layer. Does not allow for transparency or translucency
double_sided	Double Sided	Used for completely disabling backface culling.
blend	Blend	Used for a block like stained glass. Allows for transparency and translucency (slightly transparent textures).
alpha_test	Alpha Test	Used for a block like the monster spawner. Does not allow for translucency, only fully opaque or fully transparent textures. Also disabled backface culling.
alpha_test_single_sided	Alpha Test (Single Sided)	Used for a block like the (unstained) glass. Does not allow for translucency, only fully opaque or fully transparent textures. Also enables backface culling.
blend_to_opaque	Blend to Opaque	Will blend like stained glass in the near render and turn opaque on the far render.
alpha_test_to_opaque	Alpha Test to Opaque	Used for a block like the leaves. Does not allow for translucency, only fully opaque or fully transparent textures in the near render and turn only opaque on the far render. Also disabled backface culling.
alpha_test_single_sided_to_opaque	Alpha Test (Single Sided) to Opaque	Used for a block like the sugar cane. Does not allow for translucency, only fully opaque or fully transparent textures in the near render and turn only opaque on the far render. Also enables backface culling.

South item type

* Properties

Name	Default Value	Type	Description	Example Values
ambient_occlusion	not set	Decimal number	If this material has ambient occlusion applied when lighting, shadows will be created around and underneath the block. Decimal value controls exponent applied to a value after lighting.
face_dimming	not set	String	This material should be dimmed by the direction it's facing.	Blue Bubble Fish: true
isotropic	false	Boolean true/false	Should the faces that this material is applied to randomize their UVs? This item requires a format version of at least undefined.
render_method	not set	Render Method choices	The render method to use.	Blue Bubble Fish: "blend", Block Orange Ore: "opaque", Block Frond Top: "alpha_test"
texture	not set	String	Texture name for the material.	Blue Bubble Fish: "bubble_fish_blue", California Roll: "sushi_wrap", Green Bubble Fish: "bubble_fish_green"
tint_method	false	Boolean true/false	Tint multiplied to the color. Tint method logic varies, but often refers to the "rain" and "temperature" of the biome the block is placed in to compute the tint. Supported tint methods are "none", "default_foliage", "birch_foliage", "evergreen_foliage", "dry_foliage", "grass" and "water" This item requires a format version of at least undefined.

Render Method choices

Value	Title	Description
opaque	Opaque	Used for a regular block texture without an alpha layer. Does not allow for transparency or translucency
double_sided	Double Sided	Used for completely disabling backface culling.
blend	Blend	Used for a block like stained glass. Allows for transparency and translucency (slightly transparent textures).
alpha_test	Alpha Test	Used for a block like the monster spawner. Does not allow for translucency, only fully opaque or fully transparent textures. Also disabled backface culling.
alpha_test_single_sided	Alpha Test (Single Sided)	Used for a block like the (unstained) glass. Does not allow for translucency, only fully opaque or fully transparent textures. Also enables backface culling.
blend_to_opaque	Blend to Opaque	Will blend like stained glass in the near render and turn opaque on the far render.
alpha_test_to_opaque	Alpha Test to Opaque	Used for a block like the leaves. Does not allow for translucency, only fully opaque or fully transparent textures in the near render and turn only opaque on the far render. Also disabled backface culling.
alpha_test_single_sided_to_opaque	Alpha Test (Single Sided) to Opaque	Used for a block like the sugar cane. Does not allow for translucency, only fully opaque or fully transparent textures in the near render and turn only opaque on the far render. Also enables backface culling.

Up item type

* Properties

Name	Default Value	Type	Description	Example Values
ambient_occlusion	not set	Decimal number	If this material has ambient occlusion applied when lighting, shadows will be created around and underneath the block. Decimal value controls exponent applied to a value after lighting.
face_dimming	not set	String	This material should be dimmed by the direction it's facing.	Blue Bubble Fish: true
isotropic	false	Boolean true/false	Should the faces that this material is applied to randomize their UVs? This item requires a format version of at least undefined.
render_method	not set	Render Method choices	The render method to use.	Blue Bubble Fish: "blend", Block Orange Ore: "opaque", Block Frond Top: "alpha_test"
texture	not set	String	Texture name for the material.	Blue Bubble Fish: "bubble_fish_blue", California Roll: "sushi_wrap", Green Bubble Fish: "bubble_fish_green"
tint_method	false	Boolean true/false	Tint multiplied to the color. Tint method logic varies, but often refers to the "rain" and "temperature" of the biome the block is placed in to compute the tint. Supported tint methods are "none", "default_foliage", "birch_foliage", "evergreen_foliage", "dry_foliage", "grass" and "water" This item requires a format version of at least undefined.

Render Method choices

Value	Title	Description
opaque	Opaque	Used for a regular block texture without an alpha layer. Does not allow for transparency or translucency
double_sided	Double Sided	Used for completely disabling backface culling.
blend	Blend	Used for a block like stained glass. Allows for transparency and translucency (slightly transparent textures).
alpha_test	Alpha Test	Used for a block like the monster spawner. Does not allow for translucency, only fully opaque or fully transparent textures. Also disabled backface culling.
alpha_test_single_sided	Alpha Test (Single Sided)	Used for a block like the (unstained) glass. Does not allow for translucency, only fully opaque or fully transparent textures. Also enables backface culling.
blend_to_opaque	Blend to Opaque	Will blend like stained glass in the near render and turn opaque on the far render.
alpha_test_to_opaque	Alpha Test to Opaque	Used for a block like the leaves. Does not allow for translucency, only fully opaque or fully transparent textures in the near render and turn only opaque on the far render. Also disabled backface culling.
alpha_test_single_sided_to_opaque	Alpha Test (Single Sided) to Opaque	Used for a block like the sugar cane. Does not allow for translucency, only fully opaque or fully transparent textures in the near render and turn only opaque on the far render. Also enables backface culling.

West item type

* Properties

Name	Default Value	Type	Description	Example Values
ambient_occlusion	not set	Decimal number	If this material has ambient occlusion applied when lighting, shadows will be created around and underneath the block. Decimal value controls exponent applied to a value after lighting.
face_dimming	not set	String	This material should be dimmed by the direction it's facing.	Blue Bubble Fish: true
isotropic	false	Boolean true/false	Should the faces that this material is applied to randomize their UVs? This item requires a format version of at least undefined.
render_method	not set	Render Method choices	The render method to use.	Blue Bubble Fish: "blend", Block Orange Ore: "opaque", Block Frond Top: "alpha_test"
texture	not set	String	Texture name for the material.	Blue Bubble Fish: "bubble_fish_blue", California Roll: "sushi_wrap", Green Bubble Fish: "bubble_fish_green"
tint_method	false	Boolean true/false	Tint multiplied to the color. Tint method logic varies, but often refers to the "rain" and "temperature" of the biome the block is placed in to compute the tint. Supported tint methods are "none", "default_foliage", "birch_foliage", "evergreen_foliage", "dry_foliage", "grass" and "water" This item requires a format version of at least undefined.

Render Method choices

Value	Title	Description
opaque	Opaque	Used for a regular block texture without an alpha layer. Does not allow for transparency or translucency
double_sided	Double Sided	Used for completely disabling backface culling.
blend	Blend	Used for a block like stained glass. Allows for transparency and translucency (slightly transparent textures).
alpha_test	Alpha Test	Used for a block like the monster spawner. Does not allow for translucency, only fully opaque or fully transparent textures. Also disabled backface culling.
alpha_test_single_sided	Alpha Test (Single Sided)	Used for a block like the (unstained) glass. Does not allow for translucency, only fully opaque or fully transparent textures. Also enables backface culling.
blend_to_opaque	Blend to Opaque	Will blend like stained glass in the near render and turn opaque on the far render.
alpha_test_to_opaque	Alpha Test to Opaque	Used for a block like the leaves. Does not allow for translucency, only fully opaque or fully transparent textures in the near render and turn only opaque on the far render. Also disabled backface culling.
alpha_test_single_sided_to_opaque	Alpha Test (Single Sided) to Opaque	Used for a block like the sugar cane. Does not allow for translucency, only fully opaque or fully transparent textures in the near render and turn only opaque on the far render. Also enables backface culling.

Samples

Block Fabricator

"minecraft:material_instances": {
  "*": {
    "texture": "mikeamm_gwve_fabricator",
    "render_method": "alpha_test",
    "ambient_occlusion": 1
  }
}

Block Gray Ore

"minecraft:material_instances": {
  "*": {
    "texture": "mikeamm_gwve_gray_ore",
    "render_method": "alpha_test",
    "face_dimming": false
  }
}

Block Frond Top

"minecraft:material_instances": {
  "*": {
    "texture": "frond_top",
    "render_method": "alpha_test"
  }
}

Block Palm Leave Corner

"minecraft:material_instances": {
  "*": {
    "texture": "palm_leave_corner",
    "render_method": "alpha_test"
  }
}

Block Palm Leave Tip

"minecraft:material_instances": {
  "*": {
    "texture": "palm_leave_tip",
    "render_method": "alpha_test"
  }
}

Block Palm Leave

"minecraft:material_instances": {
  "*": {
    "texture": "palm_leave",
    "render_method": "alpha_test"
  }
}

Block Palm Tree Top

"minecraft:material_instances": {
  "*": {
    "texture": "chill_oasis_top",
    "render_method": "alpha_test"
  }
}

Block Palm Trunk

"minecraft:material_instances": {
  "*": {
    "texture": "palm_trunk",
    "render_method": "alpha_test"
  }
}

Block White Sand

"minecraft:material_instances": {
  "*": {
    "texture": "white_sand",
    "render_method": "alpha_test"
  }
}

Block Leaf Pile

"minecraft:material_instances": {
  "*": {
    "texture": "leaf_pile",
    "render_method": "alpha_test",
    "tint_method": "default_foliage"
  }
}

Tuna Roll

"minecraft:material_instances": {
  "north": "sushi_side",
  "south": "sushi_side",
  "*": {
    "texture": "sushi_wrap"
  },
  "sushi_side": {
    "texture": "tuna_roll"
  }
}

Blue Bubble Fish

"minecraft:material_instances": {
  "*": {
    "texture": "bubble_fish_blue",
    "render_method": "blend",
    "face_dimming": true,
    "ambient_occlusion": 1
  }
}