Model

Block models

• [NBT Compound / JSON Object] The root tag
  • [String] parent: Loads a different model from the given path, in form of a resource location. If both "parent" and "elements" are set, the "elements" tag overrides the "elements" tag from the previous model.
    • Can be set to "builtin/generated" to use a model that is created out of the specified icon. Only the first layer is supported, and rotation can be achieved only by using block states files.
  • [Boolean] ambientocclusion: Whether to use ambient occlusion (true - default), or not (false).
  • [NBT Compound / JSON Object] display: Holds the different places where item models are displayed.
    • [NBT Compound / JSON Object] Position: Named thirdperson_righthand, thirdperson_lefthand, firstperson_righthand, firstperson_lefthand, gui, head, ground, fixed, or on_shelf. Place where an item model is displayed. Holds its rotation, translation and scale for the specified situation. fixed refers to item frames, while the rest are as their name states. Translations are applied to the model before rotations.
      • [NBT List / JSON Array] rotation: Specifies the rotation of the model according to the scheme [x, y, z].
      • [NBT List / JSON Array] translation: Specifies the position of the model according to the scheme [x, y, z]. The values are clamped between -80 and 80.
      • [NBT List / JSON Array] scale: Specifies the scale of the model according to the scheme [x, y, z]. If the value is greater than 4, it is displayed as 4.
  • [NBT Compound / JSON Object] textures: Holds the textures of the model, in form of a resource location or can be another texture variable.
    • [String] Texture variable: Defines a texture variable and assigns a texture. The texture can either be a reference to another texture variable, or the resource location of a texture in the textures folder. The variable can be referenced by prefixing it with a # in the model, e.g. the variable "texture" is referenced as "#texture". The texture variable named "particle" defines what texture the breaking particles are loaded from, but can also be referenced by the model as "#particle". The particle texture is also used as an overlay if you are in a nether portal, for water and lava's still textures,^[1] and for the particle textures of non-model blocks (such as for barriers).
    • [NBT Compound / JSON Object] Texture variable: Defines a texture variable and assigns it a texture. This is an alternative format that allows specifying some extra properties of the texture. This format works for all texture variables, including "particle".
      • [String] sprite: The resource location of a texture. Note that texture variables cannot be used here.
      • [Boolean] force_translucent: Optional. Defines whether the texture should be considered translucent even when it is not. Normally, Minecraft determines whether a block is translucent by checking if any of its textures has any translucent pixels. Setting this to true overrides that behavior for this texture. This is useful for textures that don't have any translucent pixels, but use the mean mipmap strategy. Defaults to false.
  • [NBT List / JSON Array] elements: Contains all the elements of the model. They can have only cubic forms. If both "parent" and "elements" are set, the "elements" tag overrides the "elements" tag from the previous model.
    • [NBT Compound / JSON Object] An element.
      • [NBT List / JSON Array] from: Start point of a cuboid according to the scheme [x, y, z]. Values must be between -16 and 32.
      • [NBT List / JSON Array] to: Stop point of a cuboid according to the scheme [x, y, z]. Values must be between -16 and 32.
      • [NBT Compound / JSON Object] rotation: Defines the rotation of an element.
        • [NBT List / JSON Array] origin: Sets the center of the rotation according to the scheme [x, y, z].
        • [Float] x: Specifies the angle of rotation around the x axis. This value will be ignored if an axis and angle are specified.
        • [Float] y: Specifies the angle of rotation around the y axis. This value will be ignored if an axis and angle are specified.
        • [Float] z: Specifies the angle of rotation around the z axis. This value will be ignored if an axis and angle are specified.
        • [String] axis: Specifies the direction of rotation, can be "x", "y" or "z".
        • [Float] angle: Specifies the angle of rotation.
        • [Boolean] rescale: Specifies whether or not to scale the faces across the whole block by scaling the non-rotated faces by 1 / cos(angle). Can be true or false. Defaults to false.
      • [Boolean] shade: Defines if the faces of the element should be shaded according to their orientation (true - default) or not (false). This does not affect ambient occlusion or shading based on light level.
      • [Int] light_emission: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.
      • [NBT Compound / JSON Object] faces: Holds all the faces of the cuboid. If a face is left out, it does not render.
        • [NBT Compound / JSON Object] Face: Named down, up, north, south, west or east. Contains the properties of the specified face.
          • [NBT List / JSON Array] uv: Defines the area of the texture to use according to the scheme [x1, y1, x2, y2]. The texture behavior is inconsistent if UV extends below 0 or above 16. If the numbers of x1 and x2 are swapped (e.g. from 0, 0, 16, 16 to 16, 0, 0, 16), the texture flips. UV is optional, and if not supplied it automatically generates based on the element's position.
          • [String] texture: Specifies the texture in form of the texture variable prepended with a #.
          • [String] cullface: Specifies whether a face does not need to be rendered when there is a block touching it in the specified position. The position can be: down, up, north, south, west, or east. It also determines the side of the block to use the light level from for lighting the face, and if unset, defaults to the side.
          • [Int] rotation: Rotates the texture clockwise by the specified number of degrees (counterclockwise for the 'down' face). Can be 0, 90, 180, or 270. Defaults to 0. Rotation does not affect which part of the texture is used. Instead, it amounts to permutation of the selected texture vertexes (selected implicitly, or explicitly though uv).
          • [Int] tintindex: Determines whether to tint the texture using a hardcoded tint index. The default value, -1, indicates not to use the tint. Any other number is provided to BlockColors to get the tint value corresponding to that index. However, most blocks do not have a tint value defined (in which case white is used). Furthermore, no vanilla block currently uses multiple tint values, and thus the tint index value is ignored (as long as it is set to something other than -1); it could be used for modded blocks that need multiple distinct tint values in the same block though.

Item models

• [NBT Compound / JSON Object]: The root tag
  • [String] parent: Loads a different model from the given path, in form of a resource location. If both "parent" and "elements" are set, the "elements" tag overrides the "elements" tag from the previous model.
    • Can be set to "item/generated" to use a model that is created out of the specified icon.
    • Can be set to "builtin/entity" to load a model from an entity file. As you cannot specify the entity, this does not work for all items (only for chests, ender chests, mob heads, shields, banners and tridents).
  • [NBT Compound / JSON Object] display: Holds the different places where item models are displayed.
    • [NBT Compound / JSON Object] Position: Named thirdperson_righthand, thirdperson_lefthand, firstperson_righthand, firstperson_lefthand, gui, head, ground, fixed, or on_shelf. Place where an item model is displayed. Holds its rotation, translation and scale for the specified situation. fixed refers to item frames, while the rest are as their name states. Translations are applied to the model before rotations. If this is specified but not all of translation, rotation and scale are in it, the others aren't inherited from the parent.
      • [NBT List / JSON Array] rotation: Specifies the rotation of the model according to the scheme [x, y, z].
      • [NBT List / JSON Array] translation: Specifies the position of the model according to the scheme [x, y, z]. If the value is greater than 80, it is displayed as 80. If the value is less than -80, it is displayed as -80.
      • [NBT List / JSON Array] scale: Specifies the scale of the model according to the scheme [x, y, z]. If the value is greater than 4, it is displayed as 4.
  • [NBT Compound / JSON Object] textures: Holds the textures of the model, in form of a resource location or can be another texture variable.
    • [String] layerN: Used only to specify the icon of the item used in the inventory. There can be more than just one layer (e.g. for leather armor and trimmed armor), but the amount of possible layers is hardcoded for each item.^[verify] Works only in combination with "item/generated".
    • [String] particle: What texture to load particles from. Used to determine the "crumb" particles generated by food items, as well as to determine the barrier particle (but it always uses items/barrier.png as blockbreaking particle), which otherwise uses "layer0".
    • [String] Texture variable: Defines a texture variable and assigns a texture.
  • [String] gui_light: Can be "front" or "side". If set to "side", the model is rendered like a block. If set to "front", model is shaded like a flat item. Defaults to "side".
  • [NBT List / JSON Array] elements: Contains all the elements of the model. They can have only cubic forms. If both "parent" and "elements" are set, the "elements" list overrides the "elements" list from the parent model.
    • [NBT Compound / JSON Object] An element.
      • [NBT List / JSON Array] from: Start point of a cuboid according to the scheme [x, y, z]. Values must be between -16 and 32.
      • [NBT List / JSON Array] to: Stop point of a cuboid according to the scheme [x, y, z]. Values must be between -16 and 32.
      • [NBT Compound / JSON Object] rotation: Defines the rotation of an element.
        • [NBT List / JSON Array] origin: Sets the center of the rotation according to the scheme [x, y, z].
        • [String] axis: Specifies the direction of rotation, can be "x", "y" or "z".
        • [Float] angle: Specifies the angle of rotation. Can be 45 through -45 degrees.
        • [Boolean] rescale: Specifies whether or not to scale the faces across the whole block. Can be true or false. Defaults to false.
      • [Boolean] shade: Defines if the faces of the element should be shaded according to their orientation (true - default) or not (false). This does not affect ambient occlusion or shading based on light level.
      • [Int] light_emission: Defines the minimum light level that the element can receive. Can be 0-15, defaults to 0.
      • [NBT Compound / JSON Object] faces: Holds all the faces of the cuboid. If a face is left out, it does not render.
        • [NBT Compound / JSON Object] Face: Named down, up, north, south, west or east. Contains the properties of the specified face.
          • [NBT List / JSON Array] uv: Defines the area of the texture to use according to the scheme [x1, y1, x2, y2]. If unset, it defaults to values equal to xyz position of the element. The texture behavior is inconsistent if UV extends below 0 or above 16. If the numbers of x1 and x2 are swapped (e.g. from 0, 0, 16, 16 to 16, 0, 0, 16), the texture flips. UV is optional, and if not supplied it automatically generates based on the element's position.
          • [String] texture: Specifies the texture in form of the texture variable prepended with a #.
          • [String] cullface: Specifies whether a face does not need to be rendered when there is a block touching it in the specified position. The position can be: down, up, north, south, west, or east. It also determines the side of the block to use the light level from for lighting the face, and if unset, defaults to the side.
          • [Int] rotation: Rotates the texture by the specified number of degrees. Can be 0, 90, 180, or 270. Defaults to 0. Rotation does not affect which part of the texture is used. Instead, it amounts to permutation of the selected texture vertexes (selected implicitly, or explicitly though uv).
          • [Int] tintindex: Tints the texture on that face using a tint value referenced from the Items model definition. If no tint color (or the color white) is provided, the texture isn't tinted.
  • [NBT List / JSON Array] overrides: As of 24w45a/ 1.21.4+, overrides have been removed & replaced with a new system. Documentation for it can be found here.

Fields used by Blockbench

Uses of models

Limitations

Objects that cannot be remodelled

Blocks and fluids

History

Issues

References

1. ↑ MC-240042 – Water and lava textures are defined through the model particle parameter.
2. ↑ MC-308352
3. ↑ MC-276803 – Items held by dolphins use the "ground" display type – resolved as "Invalid".
4. ↑ MC-276802 – Items held by pandas unexpectedly use the "ground" display type – resolved as "Invalid".
5. ↑ MC-276763 – Item models held by foxes cannot be customized independently of dropped item models – resolved as "Invalid".
6. ↑ MC-276801 – Projectiles which use item models use the "ground" display type and cannot be independently customized from it – resolved as "Invalid".
7. ↑ MC-270987
8. ↑ MC-279011
9. ↑ MC-308377
10. ↑ MC-308413

Navigation