Attachables Documentation - minecraft:attachable

An attachable definition for Minecraft Bedrock Edition. Attachables define how items render when equipped or held by entities, including armor, weapons, tools, and other wearable/holdable items.

Note

Attachables are used to define how items render when equipped. They reference materials, textures, geometry, and optionally animations and render controllers defined in other resource pack files.

Note

In format_version 1.26.0 and higher, the pre_animation and initialize Molang script fields support multi-line {} brace scope delimiters.

Attachable Properties

Name	Default Value	Type	Description
format_version	not set	Version	The format version of this attachable file. Common versions include '1.8.0' and '1.10.0'.
minecraft:attachable	not set	Attachable item	The attachable definition container.

Attachable

Attachable Properties

JSON path: minecraft:attachable

Name	Default Value	Type	Description
description	not set	Description item	The attachable description containing all configuration.

Description

Description Properties

JSON path: minecraft:attachable > description

Name	Default Value	Type	Description
animations	not set	Key/item pairs of Animations items	Animation and animation controller definitions. Keys are short names used in scripts, values are full animation/controller identifiers.
enable_attachables	not set	Boolean true/false	Whether to allow child attachables on this attachable.
geometry	not set	Key/item pairs of Geometry items	Geometry definitions for the attachable. Keys are geometry names (e.g., 'default'), values are geometry identifiers.
identifier	not set	String	The unique identifier for this attachable. Should match the item identifier it attaches to (e.g., 'minecraft:iron_chestplate').
item	not set	String	The item identifier this attachable is associated with. If not specified, uses the attachable identifier.
materials	not set	Key/item pairs of Materials items	Material definitions for rendering the attachable. Keys are material names (e.g., 'default', 'enchanted'), values are material identifiers.
min_engine_version	not set	Integer number	The minimum engine version required for this attachable.
particle_effects	not set	Key/item pairs of Particle Effects items	Particle effect definitions for the attachable.
render_controllers	not set	Array of strings	List of render controller identifiers or conditional render controllers.
scripts	not set	Scripts item	Script definitions for the attachable, including initialization and animation triggers.
sound_effects	not set	Key/item pairs of Sound Effects items	Sound effect definitions for the attachable.
spawn_egg	not set	Spawn Egg item	Spawn egg configuration for this attachable, if applicable.
textures	not set	Key/item pairs of Textures items	Texture definitions for the attachable. Keys are texture names (e.g., 'default', 'enchanted'), values are texture paths.

Animations

Animations Properties

JSON path: minecraft:attachable > description > animations

Name	Default Value	Type	Description
[a-zA-Z0-9_]+	not set	String	An animation or animation controller identifier (e.g., 'animation.elytra.gliding', 'controller.animation.elytra.default').

Geometry

Same structure as Animations.

Materials

Same structure as Animations.

Particle Effects

Same structure as Animations.

Scripts

Scripts Properties

JSON path: minecraft:attachable > description > scripts

Name	Default Value	Type	Description
animate	not set	Array of Animate items	List of animations to play. Can be animation short names or objects with conditional playback.
animate (as Array of strings)	not set	Array of strings	Array of animation names to play.
parent_setup	not set	Molang	Molang script executed when the attachable is set up on the parent entity. Used to set variables like 'variable.chest_layer_visible = 0.0;'.
pre_animation	not set	Molang	Molang script executed before animations are processed.
scale	not set	Molang	Molang expression for the scale of the attachable.
should_update_bones_and_effects_offscreen	not set	Boolean true/false	Whether bones and effects should be updated when the entity is offscreen.
should_update_effects_offscreen	not set	Boolean true/false	Whether effects should be updated when the entity is offscreen.

Animate

Animate Properties

JSON path: minecraft:attachable > description > scripts > animate

Name	Default Value	Type	Description
animation_name	not set	String	Short name of an animation defined in the animations section.

Sound Effects

Same structure as Animations.

Spawn Egg

Spawn Egg Properties

JSON path: minecraft:attachable > description > spawn_egg

Name	Default Value	Type	Description
texture	not set	String	Texture path for the spawn egg.
texture_index	not set	Integer number	Index into the spawn egg texture atlas.

Textures

Same structure as Animations.

Samples

Armor

{
  "format_version": "1.8.0",
  "minecraft:attachable": {
    "description": {
      "identifier": "minecraft:iron_chestplate",
      "materials": {
        "default": "armor",
        "enchanted": "armor_enchanted"
      },
      "textures": {
        "default": "textures/models/armor/iron_1",
        "enchanted": "textures/misc/enchanted_actor_glint"
      },
      "geometry": {
        "default": "geometry.humanoid.armor.chestplate"
      },
      "scripts": {
        "parent_setup": "variable.chest_layer_visible = 0.0;"
      },
      "render_controllers": [
        "controller.render.armor"
      ]
    }
  }
}

Elytra

{
  "format_version": "1.10.0",
  "minecraft:attachable": {
    "description": {
      "identifier": "minecraft:elytra",
      "materials": {
        "default": "elytra",
        "enchanted": "elytra_glint"
      },
      "textures": {
        "default": "textures/models/armor/elytra",
        "enchanted": "textures/misc/enchanted_actor_glint"
      },
      "geometry": {
        "default": "geometry.elytra"
      },
      "animations": {
        "default_controller": "controller.animation.elytra.default",
        "gliding": "animation.elytra.gliding"
      },
      "scripts": {
        "parent_setup": "variable.chest_layer_visible = 0.0;",
        "animate": [
          "default_controller"
        ]
      },
      "render_controllers": [
        "controller.render.armor"
      ]
    }
  }
}