Bedrock Wiki
  • Discord
  • Contribute
  • bedrock.dev
  • MS Learn
Beginner's Guide
  • Guide
    • 1. Introduction
      guide
    • 2. Add-Ons Explained
    • 3. Software & Preparation
    • 4. Project Setup
    • 5. Create a Custom Item
    • 6. Create a Custom Entity
    • 7. Blockbench: Modeling, Texturing & Animating
    • 8. Adding a Loot Table, Spawn Rule & Crafting Recipe
  • Extra
    • a. Understanding JSON
    • b. Download Example Packs
    • c. Troubleshooting
      help
    • d. Advanced Manifest
    • e. Format Versions
    • f. Project Setup Android
Animation Controllers
  • Intro to Animation Controllers
    guide
  • Entity Commands
  • AFK Detector
  • Death Commands
  • Molang into Scoreboard
  • Respawn Commands
Blocks
  • General
    • Intro to Blocks
      guide
    • Block Components
    • Block Tags
    • Block States
    • Block Traits
    • Block Permutations
    • Block Events
      Scripts
    • Block Event Migration
      help
    • Blocks as Items
    • Troubleshooting Blocks
      help
  • Visuals
    • Block Culling
    • Block Models
      guide
    • Block Texture Animation
    • Block Texture Variation
    • Block Tinting
  • Tutorials
    • Applying Constant Effects
      Scripts
    • Avoiding State Limit
    • Fake Blocks
      Scripts
    • Ore Loot Tables
      Scripts
    • Precise Interaction
      Scripts
    • Precise Rotation
      Scripts
    • Rotatable Blocks
  • Vanilla Re-Creations
    • Custom Crops
      Scripts
    • Custom Glass
    • Custom Glazed Terracotta
    • Custom Trapdoors
      Scripts
  • Documentation
    • Block Format History
    • Block Shapes
    • Block Sounds
    • Vanilla Block Models
Commands
  • General
    • Intro to Command Blocks
    • Functions
    • Block States
    • Coordinate System
    • NBT Commands
    • Scoreboard Operations
    • Understanding Selectors
  • Commands
    • Damage
    • Execute
    • Playanimation
    • Playsound
  • On Event Systems
    • On Player First Join
    • On Player Join
    • On Player Leave
    • On Player Death
    • On Player Respawn
    • On First World Load
  • Scoreboard Systems
    • Entity Counter
    • Scoreboard Timers
    • Comparing And Retrieving Scores
  • Techniques
    • Execute Logic Gates
    • MBE - Max's Block Entity
    • FMBE - A New Way to Create Display Entities
    • Look Detection
    • Movement Detections
    • Orbital Camera
  • Useful Creations
    • Custom Crafter
    • Multiplayer Position Rearrangement
      function
Concepts
  • contents.json
  • Emojis & Symbols
  • Molang
  • Namespaces
  • Overwriting Assets
  • Raw Text
  • Shaders
  • Sounds
  • Subpacks
  • Text and Localization
  • Texture Atlases
  • textures_list.json
Documentation
  • Shared Constructs
  • Advanced Molang
  • File Types
  • Fog IDs
  • Material Configuration Description
  • Menu Categories
  • Molang Queries
  • Pack Folder Structure
  • Sound Definitions
  • Vanilla Materials
Entities
  • General
    • Intro to Entities BP
      guide
    • Intro to Entities RP
      guide
    • Troubleshooting Entities
      help
    • Entity Events
    • Entity Properties
    • NPC Dialogues
    • Render Controllers
    • Spawn Rules
  • Tutorials
    • Convert Points Between Any Space (World, Entity, Bones)
    • Creating Boats
    • Detecting Other Entities
    • Disabling Team Damage
    • Dummy Entities
    • Entity Attacks
    • Entity Holds Item
    • Entity Movement
    • Entity Timers
    • Flying Entities
    • Introduction to AOE Clouds
    • Invulnerable Entities
    • Look at Entity
    • Sleeping Entities
    • Solid Entities
    • Spawning Tamed Entities
      Scripts
    • Village Mechanic
  • Documentation
    • Dummy Components
    • Non-Mob Runtime Identifiers
    • Projectiles
    • Runtime Identifiers
    • Vanilla Usage Components
    • Vanilla Usage Spawn Rules
Items
  • General
    • Intro to Items
      guide
    • Item Components
    • Item Tags
    • Item Events
      Scripts
    • Item Event Migration
      help
    • Troubleshooting Items
      help
  • Tutorials
    • Custom Armor
    • Custom Food
      Scripts
    • Custom Pottery Sherds
    • Custom Weapons
    • Equipment-Based Commands
    • High Resolution Items
    • Spawning Items
    • Throwable Items
  • Documentation
    • Enchantments
    • Attachables
    • Item Format History
    • Numerical Item IDs
    • Vanilla Item Identifiers
    • Vanilla Usage Components
JSON UI
  • General
    • Intro to JSON UI
      guide
    • Best Practices
      guide
  • Tutorials
    • Adding HUD Elements
    • Aseprite Animations
    • Buttons and Toggles
    • Modifying Server Forms
    • Preserve Title Texts
    • String to Number
  • Documentation
    • JSON UI Documentation
Loot, Recipes & Trading
  • General
    • Trading Behavior
  • Documentation
    • Loot Tables
    • Trade Tables
    • Recipes
    • Item Functions
  • Tutorials
    • Randomized Structure Loot
Meta
  • Add-On Performance
  • Style Guide
  • Useful Links
  • Using Schemas
  • Version Control
  • Q&A
    • Blocks and Items Q&A 2024/08/30
    • Deferred Technical Preview Q&A 2024/02/23
    • GameTest Q&A 2021/08/06
    • Scripting and Editor Q&A 2023/09/22
    • World Generation Q&A 2024/11/15
NBT
  • General
    • .mcstructure
  • Tutorials
    • Experiments in Education Edition
    • Extending Structure Limits
  • NBT in Depth
    • About NBT (Named Binary Tag)
    • NBT Libraries
    • Reading NBT Example
Particles
  • General
    • Intro to Particles
      guide
  • Tutorials
    • Disabling Particles
  • Documentation
    • Vanilla Particles
Scripting
  • General
    • Intro to Scripting
    • What is Script API?
    • API Modules
  • Tutorials
    • Block Placement Prevention
    • GameTests
    • Script Core Features
    • Script Forms
    • Script Requests API
    • Simple Chat Commands
  • Documentation
    • Engine Environment
    • Script Resources
    • Script Watchdog
    • Troubleshooting JavaScript
    • TypeScript
Servers
  • Software
    • Bedrock Server Software
  • Protocols
    • Bedrock Protocol
    • NetherNet Protocol
    • RakNet Protocol
Visuals
  • General
    • Introduction to Entity Visuals
      guide
    • Bedrock Modeling
    • Custom Death Animations
    • Effects in Animations
    • Material Creations
    • Materials
    • Math-Based Animations
    • Skin Packs
  • Tutorials
    • Entity Texture Animation
    • Glowing Entity Texture
    • Hurt Animations
    • Leash Position
    • Player Geometry
    • Remove Entity Shadows
    • Retexturing Spawn Eggs
  • Ideas
    • Structure Presentation
World Generation
  • General
    • Intro to World Generation
      guide
    • Biomes
      guide
    • Feature Types
    • Jigsaw Structures
  • Tutorials
    • Block Conditions for Features
    • Generating Custom Ores
    • Generating Custom Structures
    • Generating Patches
    • Heightmap Noise
  • Documentation
    • Biome Tags

Custom Armor

Custom Armor
  • Chestplate
  • Adding the Attachable
  • Leggings
  • Helmet
  • Boots
  • Bonus - Making Set Effects

TIP

It is highly recommended that you look over the Blockbench modelling and texturing section in the beginner's guide before tackling these sections.

Making custom armors is surprisingly easy to do, you need to do a bit of fiddling around as there are a few files that need to be added and there can be a little bit of texturing involved but you can do as much or as little as you want here.

Chestplate ​

Create a chest piece:

BP/items/my_chest.json
json
{
    "format_version": "1.21.70",
    "minecraft:item": {
        "description": {
            "identifier": "wiki:my_chest",
            // Notice we give it the equipment category
            "menu_category": {
                "category": "equipment",
                "group": "minecraft:itemGroup.name.chestplate"
            }
        },
        "components": {
            // The icon we want to use in our INVENTORY
            "minecraft:icon": "wiki:my_chest",
            // We give it a name
            "minecraft:display_name": {
                "value": "My Custom Armor"
            },
            // We don't want it to stack
            "minecraft:max_stack_size": 1,
            // We make sure it can only receive enchantments for chest pieces
            "minecraft:enchantable": {
                "value": 10,
                "slot": "armor_torso"
            },
            // We want it to be repairable, and what to use to repair it
            "minecraft:repairable": {
                "repair_items": [
                    {
                        "items": ["minecraft:stick"],
                        "repair_amount": "context.other->q.remaining_durability + 0.05 * context.other->q.max_durability"
                        // Some complicated molang; just copy it
                    }
                ]
            },
            // Mark it as a wearable and that it goes in the chest slot
            "minecraft:wearable": {
                "slot": "slot.armor.chest",
                "protection": 5
            },
            // Provide its durability
            "minecraft:durability": {
                "max_durability": 200
            }
        }
    }
}
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
35
36
37
38
39
40
41
42
43
44
45
46
47

At this point you could just go and add an item texture into your RP/textures/item_texture.json with the key my_chest and you are on your way. We have attached a default item texture for your armor here if you want to just follow along.

Download texture here

Adding the Attachable ​

At this point your item would appear in game and would be wearable but it would not have any appearance. This is because we need to tell it how to handle the attachable equipment and give it a texture to show.

To start with you need to create an attachables folder in your RP (you may already have one).

RP/attachables/my_chest.json
json
{
    "format_version": "1.8.0",
    "minecraft:attachable": {
        "description": {
            "identifier": "wiki:my_chest",
            // These 2 are default and are required
            "materials": {
                "default": "armor",
                "enchanted": "armor_enchanted"
            },
            "textures": {
                // This is our CUSTOM armor texture we need to make next
                "default": "textures/models/armor/custom_main",
                // This texture is included in the vanilla RP and is used for the enchantment glint
                "enchanted": "textures/misc/enchanted_actor_glint"
            },
            // We tell it what geometry to use for the chestplate
            "geometry": {
                "default": "geometry.player.armor.chestplate"
            },
            // We tell it to hide the chest layer as we will be showing our armor on top
            "scripts": {
                "parent_setup": "v.chest_layer_visible = 0.0;"
            },
            // We tell it what controller to use (default armor one)
            "render_controllers": ["controller.render.armor"]
        }
    }
}
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

At this point we need to make sure we create a texture for our model, these live in RP/textures/models/armor. We however actually need 2 textures, as one is for the main armor as if it is being worn all together, and one is for the legs which when worn alone will often cover some of the boot area.

If you do not feel creative we have provided a recoloured diamond armour skin for use with this tutorial. So just Save As and plop them in the folder.

Download texture here

Download texture here

In the real world you would probably want to use Blockbench or some photo editing program to edit the textures and ideally see how they look on a model before you add them into the add-on. If you now go into the game and check what you have produced you should be able to wear your chest piece and pat yourself on the back for a job well done.

Leggings ​

So while the chest piece alone is great, you probably want a whole set, so from here if you make another item json for the boots like so.

BP/items/my_leggings.json
json
{
    "format_version": "1.21.70",
    "minecraft:item": {
        "description": {
            "identifier": "wiki:my_leggings",
            "menu_category": {
                "category": "equipment",
                "group": "minecraft:itemGroup.name.leggings"
            }
        },
        "components": {
            // Give it an applicable ITEM texture
            "minecraft:icon": "wiki:my_leggings",
            "minecraft:display_name": {
                "value": "My Custom Leggings"
            },
            "minecraft:max_stack_size": 1,
            // Make sure the enchantments are for legs
            "minecraft:enchantable": {
                "value": 10,
                "slot": "armor_legs"
            },
            "minecraft:repairable": {
                "repair_items": [
                    {
                        "items": ["minecraft:stick"],
                        "repair_amount": "context.other->q.remaining_durability + 0.05 * context.other->q.max_durability"
                    }
                ]
            },
            // Make sure the wearable slot is legs
            "minecraft:wearable": {
                "slot": "slot.armor.legs",
                "protection": 3
            },
            "minecraft:durability": {
                "max_durability": 200
            }
        }
    }
}
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
35
36
37
38
39
40
41

This is great and like before you will need to add your own item texture, although here is one if you just want to continue.

Download texture here

Once we are done here we need to create the attachables file like this:

RP/attachables/my_leggings.json
json
{
    "format_version": "1.8.0",
    "minecraft:attachable": {
        "description": {
            "identifier": "wiki:my_leggings",
            // Notice this is the same as before
            "materials": {
                "default": "armor",
                "enchanted": "armor_enchanted"
            },
            "textures": {
                // Same as before
                "enchanted": "textures/misc/enchanted_actor_glint",
                // This one is different as we are using the legging specific texture
                "default": "textures/models/armor/custom_legs"
            },
            // Tell it to use leggings geom
            "geometry": {
                "default": "geometry.humanoid.armor.leggings"
            },
            // Hide legs layer as we will be rendering over it
            "scripts": {
                "parent_setup": "v.leg_layer_visible = 0.0;"
            },
            // Same as before
            "render_controllers": ["controller.render.armor"]
        }
    }
}
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

Given that we have already put in the textures needed we can run it and see our legs straight away.

Helmet ​

This is just like the chest piece, just we change some of the categories and slots like so.

BP/items/my_helm.json
json
{
    "format_version": "1.21.70",
    "minecraft:item": {
        "description": {
            "identifier": "wiki:my_helm",
            "menu_category": {
                "category": "equipment",
                "group": "minecraft:itemGroup.name.helmet"
            }
        },
        "components": {
            "minecraft:icon": "wiki:my_helm",
            "minecraft:display_name": {
                "value": "My Custom Helmet"
            },
            "minecraft:max_stack_size": 1,
            // Helm enchantment slot
            "minecraft:enchantable": {
                "value": 10,
                "slot": "armor_head"
            },
            "minecraft:repairable": {
                "repair_items": [
                    {
                        "items": ["minecraft:stick"],
                        "repair_amount": "context.other->q.remaining_durability + 0.05 * context.other->q.max_durability"
                    }
                ]
            },
            // Wearable head slot
            "minecraft:wearable": {
                "slot": "slot.armor.head",
                "protection": 3
            },
            "minecraft:durability": {
                "max_durability": 200
            }
        }
    }
}
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
35
36
37
38
39
40

As you can see not much has changed, we just update the categories/slots to the correct ones for helms and then we add the attachables file (here is the item texture if you need it).

Download texture here
RP/attachables/my_helm.json
json
{
    "format_version": "1.8.0",
    "minecraft:attachable": {
        "description": {
            "identifier": "wiki:my_helm",
            // These 2 are default and are required
            "materials": {
                "default": "armor",
                "enchanted": "armor_enchanted"
            },
            "textures": {
                // This is our CUSTOM armor texture we need to make next
                "default": "textures/models/armor/custom_main",
                // This texture doesn't actually exist in our RP
                // but it will blow up without it so leave it in
                "enchanted": "textures/misc/enchanted_actor_glint"
            },
            // We tell it what geometry to use for the helmet
            "geometry": {
                "default": "geometry.player.armor.helmet"
            },
            // We tell it to hide the helmet layer as we will be showing our armor on top
            "scripts": {
                "parent_setup": "v.helmet_layer_visible = 0.0;"
            },
            // We tell it what controller to use (default armor one)
            "render_controllers": ["controller.render.armor"]
        }
    }
}
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

There you go, you now have 3/4 of a complete set, we may as well go through the boots as well so you know all the categories etc.

Boots ​

You already know the pattern so lets make the item and attachable json files.

BP/items/my_boots.json
json
{
    "format_version": "1.21.70",
    "minecraft:item": {
        "description": {
            "identifier": "wiki:my_boots",
            "menu_category": {
                "category": "equipment",
                "group": "minecraft:itemGroup.name.boots"
            }
        },
        "components": {
            "minecraft:icon": "wiki:my_boots",
            "minecraft:display_name": {
                "value": "My Custom Boots"
            },
            "minecraft:max_stack_size": 1,
            // Enchantable Feet
            "minecraft:enchantable": {
                "value": 10,
                "slot": "armor_feet"
            },
            "minecraft:repairable": {
                "repair_items": [
                    {
                        "items": ["minecraft:stick"],
                        "repair_amount": "context.other->q.remaining_durability + 0.05 * context.other->q.max_durability"
                    }
                ]
            },
            // Feet slot
            "minecraft:wearable": {
                "slot": "slot.armor.feet",
                "protection": 3
            },
            "minecraft:durability": {
                "max_durability": 200
            }
        }
    }
}
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
35
36
37
38
39
40

The custom boots texture if you need it.

Download texture here
RP/attachables/my_boots.json
json
{
    "format_version": "1.8.0",
    "minecraft:attachable": {
        "description": {
            "identifier": "wiki:my_boots",
            // These 2 are default and are required
            "materials": {
                "default": "armor",
                "enchanted": "armor_enchanted"
            },
            "textures": {
                // This is our CUSTOM armor texture we need to make next
                "default": "textures/models/armor/custom_main",
                // This texture doesn't actually exist in our RP
                // but it will blow up without it so leave it in
                "enchanted": "textures/misc/enchanted_actor_glint"
            },
            // We tell it what geometry to use for the boots
            "geometry": {
                "default": "geometry.player.armor.boots"
            },
            // We tell it to hide the boots layer as we will be showing our armor on top
            "scripts": {
                "parent_setup": "v.boot_layer_visible = 0.0;"
            },
            // We tell it what controller to use (default armor one)
            "render_controllers": ["controller.render.armor"]
        }
    }
}
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

Thats it, you now have a whole suit of custom armor you can swagger around in, and use this as a basis to make whatever other armors you want in the game.

It is worth noting that we have used 2 separate textures here, and you could potentially use a texture per attachable, but each new texture consumes memory so its best to use as few as possible. So this is what you should end up with, and as a bonus there is one more section on making set effects using filters, which is a bit more advanced but its a fun thing to do.

Bonus - Making Set Effects ​

This is a bit more advanced but lets say you want your custom armor to act like it's a set from an RPG game. We can add some code to check if we have the set equipped and do some great stuff with it.

Note that for effects you can use tick.json and functions with hasitem selector argument to avoid using player.json.

In this example we will just add a chance to teleport the attacker somewhere nearby and put a blurb on the console for flavour.

As we want this to trigger when the player is hit we need to add some logic to the player.json file. This is a huge file and we unfortunately need to make sure it has all the default content in there as well due to the way it will overwrite the default player components etc.

So rather than include the whole player.json I will just include the parts you will need to add to your components and events sections. If you have no idea what the player.json is then look in the vanilla behavior pack and look for it and just copy it over into your project.

So first of all lets put in the damage sensor component (which goes in your component section) which listens for when you take damage and lets you raise an event from it.

BP/entities/player.json#components
json
"minecraft:damage_sensor": {
    "triggers": {
        "on_damage": {
            "filters": {
                "all_of": [
                    {
                        "test": "has_equipment",
                        "subject": "self",
                        // Domain is the body part in this case
                        "domain": "head",
                        "operator": "==",
                        // The item identifier we want to check
                        "value": "wiki:my_helm"
                    },
                    {
                        "test": "has_equipment",
                        "subject": "self",
                        "domain": "torso",
                        "operator": "==",
                        // Worth noting you can omit prefix for minecraft internal items i.e stick
                        "value": "wiki:my_chest"
                    },
                    {
                        "test": "has_equipment",
                        "subject": "self",
                        "domain": "leg",
                        "operator": "==",
                        "value": "wiki:my_leggings"
                    },
                    {
                        "test": "has_equipment",
                        "subject": "self",
                        "domain": "feet",
                        "operator": "==",
                        "value": "wiki:my_boots"
                    }
                ]
            },
            // If all the triggers match in the filter raise the event
            "event": "wiki:armor_sets.my_custom.taken_damage"
        },
        // This means if it matches the check it still applies damage
        // Can be good to ignore team damage or similar scenarios
        "deals_damage": true
    }
}
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
35
36
37
38
39
40
41
42
43
44
45
46

As you can see from the comments, there is a lot there but really all we are doing is listening out for something then making sure we only filter the results we care about then relay on an event.

The event can be called anything but it is often better to have it more specific, incase you end up having multiple similar events etc, also it can help finding if you have multiple sections to it, i.e I could search on "armour_sets" and find all events related to it. Then once you are done, in the same file we decide what we want to do with the event, which we put into our events section.

BP/entities/player.json#events
json
"wiki:armor_sets.my_custom.taken_damage": {
    "randomize": [
        {
            "weight": 1,
            // We do a sequence here as we want to apply one command
            // on one entity and the other on ourselves
            "sequence": [
                {
                    // This will take the attacker/other because it was in context
                    // at time of raising the event in the damage_sensor
                    "queue_command": {
                        // Teleport the entity away from us
                        "command": "spreadplayers ~~ 5 20 @s",
                        // Run the command on the attacker not us
                        "target": "other"
                    }
                },
                {
                    "queue_command": {
                        "command": "tellraw @s{\"rawtext\":[{\"text\":\"§aYour Armor Glows and the Enemy Vanishes\"}]}"
                    }
                }
            ]
        },
        {
            // Dummy weighting so it happens semi frequently
            "weight": 20
        }
    ]
}
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

Thats it, you can rejig the bits how you see fit but ultimately you have all the pieces to apply effects to armor and check for if you have the whole set applied or check for other equipment.

You can also change the equipment checks from self to other and check if whoever is attacking you has something equipped or even check if you are attacking a sort of block/entity and do different effects based on that. We haven't touched on that directly here but there is a good enough starting point to get you on your way and let you be creative with things.

Contributors

Edit Custom Armor on GitHub

Bedrock Wiki by Bedrock OSS

"Minecraft" is a trademark of Mojang AB.

Bedrock OSS, Bedrock Wiki and bedrock.dev are not affiliated in any way with Microsoft or Mojang AB.

  • Privacy Policy
  • Join our Discord
  • Learn how to Contribute
  • Visit our Repository