Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
Defines a geometry document (bones, cubes, and UV mappings) with format_version 1.21.0.
Geometry (v1.21.0) Properties
| Name | Default Value | Type | Description |
|---|---|---|---|
| debug | not set | Boolean true/false | |
| format_version | not set | Version | |
| minecraft:geometry | not set | Array of Geometry items | |
| minecraft:geometry (as Array of strings) | not set | Array of strings |
Geometry
Geometry Properties
JSON path: minecraft:geometry
| Name | Default Value | Type | Description |
|---|---|---|---|
| bones | not set | Array of Bones items | |
| bones (as Array of strings) | not set | Array of strings | Bones define the 'skeleton' of the mob: the parts that can be animated, and to which geometry and other bones are attached. |
| cape | not set | String | |
| description | not set | Description item | |
| item_display_transforms | not set | Item Display Transforms item | Components of the 3d matrix transform to be applied to this geometry when displayed in this item rendering context. |
item_display_transforms
Components of the 3d matrix transform to be applied to this geometry when displayed in this item rendering context. Valid contexts: ["gui", "firstperson_righthand", "firstperson_lefthand", "thirdperson_righthand", "thirdperson_lefthand", "ground", "fixed", "head", "embedded", "shelf"].
Bones
Bones Properties
JSON path: minecraft:geometry > bones
| Name | Default Value | Type | Description |
|---|---|---|---|
| binding | not set | Molang | Useful for items. |
| cubes | not set | Array of Cubes items | |
| cubes (as Array of strings) | not set | Array of strings | This is the list of cubes associated with this bone. |
| debug | not set | Boolean true/false | |
| locators | not set | Key/item pairs of Locators items | |
| locators (as Keyed set of strings) | not set | Keyed set of strings | This is a list of locators associated with this bone. |
| mirror | not set | Boolean true/false | Mirrors the UV's of the unrotated cubes along the x axis, also causes the east/west faces to get flipped. |
| name | not set | String | Animation files refer to this bone via this identifier. |
| parent | not set | String | Bone that this bone is relative to. If the parent bone moves, this bone will move along with it. |
| pivot | not set | Array of strings | |
| poly_mesh | not set | Key/item pairs of Poly Mesh items | [Deprecated] A triangle or quad mesh object. Can be used in conjunction with cubes and texture geometry. This feature is deprecated, and using it in new content will result in content errors. |
| render_group_id | not set | Integer number | |
| rotation | not set | Array of strings | |
| texture_meshes | not set | Array of Texture Meshes items | |
| texture_meshes (as Array of strings) | not set | Array of strings | Adds a mesh to the bone's geometry by converting texels in a texture into voxels. |
binding
Useful for items. A molang expression specifying the bone name of the parent skeletal hierarchy that this bone should use as the root transform. Without this field it will look for a bone in the parent entity with the same name as this bone. If both are missing, it will assume a local skeletal hierarchy (via the "parent" field). If that is also missing, it will attach to the owning entity's root transform.
locators (as Keyed set of strings)
This is a list of locators associated with this bone. A locator is a point in model space that tracks a particular bone as the bone animates (by maintaining it's relationship to the bone through the animation).
Cubes
Cubes Properties
JSON path: minecraft:geometry > bones > cubes
| Name | Default Value | Type | Description |
|---|---|---|---|
| mirror | not set | Boolean true/false | Mirrors this cube about the unrotated x axis (effectively flipping the east / west faces), overriding the bone's 'mirror' setting for this cube. |
| origin | not set | Array of strings | |
| pivot | not set | Array of strings | |
| rotation | not set | Array of strings | |
| size | not set | Array of strings | |
| uv | not set | Uv item | This is an alternate per-face uv mapping which specifies each face of the cube. Omitting a face will cause that face to not get drawn. |
| uv (as Array of strings) | not set | Array of strings |
Uv
Uv Properties
JSON path: minecraft:geometry > bones > cubes > uv
| Name | Default Value | Type | Description |
|---|---|---|---|
| down | not set | Down item | Specifies the UV's for the face that stretches along the x and z axes, and faces the -y axis |
| east | not set | East item | Specifies the UV's for the face that stretches along the z and y axes, and faces the x axis |
| north | not set | North item | Specifies the UV's for the face that stretches along the x and y axes, and faces the -z axis. |
| south | not set | South item | Specifies the UV's for the face that stretches along the x and y axes, and faces the z axis |
| up | not set | Up item | Specifies the UV's for the face that stretches along the x and z axes, and faces the y axis |
| west | not set | West item | Specifies the UV's for the face that stretches along the z and y axes, and faces the -x axis |
Down
Down Properties
JSON path: minecraft:geometry > bones > cubes > uv > down
| Name | Default Value | Type | Description |
|---|---|---|---|
| material_instance | not set | String | |
| uv | not set | Array of strings | |
| uv_rotation | not set | Integer number | Rotates the uv rect clockwise the specified amount of degrees before applying it to the face. Valid values are 0, 90, 180 and 270. If not specified, no rotation will be applied. |
| uv_size | not set | Array of strings |
East
Same structure as Down.
North
Same structure as Down.
South
Same structure as Down.
Up
Same structure as Down.
West
Same structure as Down.
Locators
Locators Properties
JSON path: minecraft:geometry > bones > locators
| Name | Default Value | Type | Description |
|---|---|---|---|
| ignore_inherited_scale | not set | Boolean true/false | Discard scale inherited from parent bone. |
| offset | not set | Array of strings | |
| rotation | not set | Array of strings |
Poly Mesh
Poly Mesh Properties
JSON path: minecraft:geometry > bones > poly_mesh
| Name | Default Value | Type | Description |
|---|---|---|---|
| normalized_uvs | not set | Boolean true/false | If true, UVs are assumed to be [0-1]. If false, UVs are assumed to be [0-texture_width] and [0-texture_height] respectively. |
| normals | not set | Array of strings | |
| polys | not set | Array of strings | |
| positions | not set | Array of strings | |
| uvs | not set | Array of strings |
Texture Meshes
Texture Meshes Properties
JSON path: minecraft:geometry > bones > texture_meshes
| Name | Default Value | Type | Description |
|---|---|---|---|
| local_pivot | not set | Array of strings | |
| position | not set | Array of strings | |
| rotation | not set | Array of strings | |
| scale | not set | Array of strings | |
| texture | not set | String | The friendly-named texture to use. |
| use_pixel_depth | not set | Boolean true/false | If set to "true", the geometry will have a depth of one pixel (in entity space, not texture space). |
use_pixel_depth
If set to "true", the geometry will have a depth of one pixel (in entity space, not texture space). This causes geometries with a texture resolution different from 16x16 to appear stretched. If set to "false", the geometry will be built from perfectly cubic voxels, no matter the texture's aspect ratio. The default value is "true".
Description
Description Properties
JSON path: minecraft:geometry > description
| Name | Default Value | Type | Description |
|---|---|---|---|
| identifier | not set | String | Entity definition and Client Block definition files refer to this geometry via this identifier. |
| texture_height | not set | Integer number | Assumed height in texels of the texture that will be bound to this geometry. |
| texture_width | not set | Integer number | Assumed width in texels of the texture that will be bound to this geometry. |
| visible_bounds_offset | not set | Array of strings |
Item Display Transforms
Item Display Transforms Properties
JSON path: minecraft:geometry > item_display_transforms
| Name | Default Value | Type | Description |
|---|---|---|---|
| embedded | not set | Embedded item | |
| firstperson_lefthand | not set | Firstperson Lefthand item | |
| firstperson_righthand | not set | Firstperson Righthand item | |
| fixed | not set | Fixed item | |
| ground | not set | Ground item | |
| gui | not set | Gui item | |
| head | not set | Head item | |
| shelf | not set | Shelf item | |
| thirdperson_lefthand | not set | Thirdperson Lefthand item | |
| thirdperson_righthand | not set | Thirdperson Righthand item |
Embedded
Embedded Properties
JSON path: minecraft:geometry > item_display_transforms > embedded
| Name | Default Value | Type | Description |
|---|---|---|---|
| rotation | not set | Array of strings | |
| rotation_pivot | not set | Array of strings | |
| scale | not set | Array of strings | |
| scale_pivot | not set | Array of strings | |
| translation | not set | Array of strings |
Firstperson Lefthand
Same structure as Embedded.
Firstperson Righthand
Same structure as Embedded.
Fixed
Same structure as Embedded.
Ground
Same structure as Embedded.
Gui
Gui Properties
JSON path: minecraft:geometry > item_display_transforms > gui
| Name | Default Value | Type | Description |
|---|---|---|---|
| fit_to_frame | not set | Boolean true/false | If true, the geometry will be automatically scaled and translated to fit within the GUI frame. Default is 'true'. |
| rotation | not set | Array of strings | |
| rotation_pivot | not set | Array of strings | |
| scale | not set | Array of strings | |
| scale_pivot | not set | Array of strings | |
| translation | not set | Array of strings |
Head
Same structure as Embedded.
Shelf
Same structure as Embedded.
Thirdperson Lefthand
Same structure as Embedded.
Thirdperson Righthand
Same structure as Embedded.