Armors
Wear texture configuration
equipments:
my_armor_1:
type: armor
layer_1: armor/my_armor_1/layer_1
layer_2: armor/my_armor_1/layer_2The equipment is a property which contains the information how to show the armor in-game on the player body.
Create the layers files inside the folder: contents/my_armor_tutorial/textures/armor/my_armor_1 .
Item configuration
In this example I will show how to create a chestplate, the same can be done to create other armor pieces.
As you can see I set the material to IRON_CHESTPLATE.
I also set the equipment.id property to my_armor_tutorial:my_armor_1.
This loads our previously created equipment settings.
Inventory item textures
Create the item texture and put it inside the folder:
contents/my_armor_tutorial/textures/item.
Extra: Custom 3D helmet
Currently only helmets support 3D models due to a Minecraft limitation I cannot fix.
Do not put any id in the equipment, otherwise the previous layer texture would be used instead of the custom model_path.
Full configuration from the previous example
Animated/emissive armors
The current custom armors method doesn't support animated and emissive textures. To create animated or/and emissive textures you have to use the Old Textured method (uses shaders).
HD armor textures
I do not advice to use HD textures since this is a blocky game, but can create HD high resolution, but make sure they have the same proportions of the original vanilla armors layers textures.
Size must be a power of 2, for example: 64x32, 128x64, 256x128, 512x256.
Converting old armors to the new equipment tag
This option will convert the armors completely to use the new equipment tag. Note that old clients won't see the armor anymore (older than 1.21.2).
Custom wear texture
The vanilla feature requires Minecraft 1.17 or greater.
It can't work on Minecraft 1.16 and previous versions.
To make 1.16 clients see the custom armors you can enable also the optifine attribute, this will allow old clients to see the armors anyway.
This is also useful as fallback for people who use custom shaders, which are not compatible with the custom armors vanilla shaders.
If you see bugged textures and you have Optifine installed please read here.
Creating the armor renderer
An armor renderer is a setting which contains the information how to show the armor ingame on the player body. It is a configuration which specified how the game will show the armor ingame.
Note: there can be only one armor renderer with per color.
You must decide a color! Even if the armor won't be colored. The color is like an ID (identifier) for the custom armor renderer.
use_color: falsedisables the recoloring of the armor using the specifiedcolor: "#d60000". It would have colored the armor texture if were set totrue. In some cases you may want to recolor the armor using the specifiedcolor, so you will have to set it totrue. This option will also make the item (in inventory) not colored automatically anymore.coloris the color attribute of this armor. It acts like an unique identifier for the armor (and will tint the armor ifuse_coloristrue). Use this website to get a valid color: https://minecraftcommand.science/armor-color. Note: ItemsAdder will automatically select a nearest unused color if the selected one is already used by another custom armor.
Now I create the two PNG files inside the contents/my_items/textures/armor/my_armor/ folder.
HD armor textures
You can create HD high resolution armors too! Just make sure they have the same proportions of the original. For example: 64x32, 128x64, 256x128, 512x256... it's very important! Size must be a power of 2.
It's not really advised to use HD textures since this is a blocky game. Lot of HD textures can cause issues because there is a different size limit for each Graphical Card.
So it's better to stick with the vanilla texture size if you want to avoid risking issues.
Creating an armor piece
Let's create a chestplate.
To create other pieces you just have to repeat the following method and change the slot.
Make sure that no material property is set. This is handled automatically by the plugin for custom textured armors. Armor won't work if a material has been set.
The custom_armor property is important, it makes the plugin apply the previous armors_renderer setting to this armor piece.
In this case I didn't specify any color in the specific_properties field of the armor piece because it's automatically applied by the custom_armor property, inherited from the armors_renderer.
Now I create the item texture and I put it inside the folder:
contents/my_items/textures/item/my_armor/.
In this example I created also a new folder called my_armor to better organize the resourcepack since you will have 1 texture for each armor piece, and having them in the same textures folder might cause confusion.
contents/my_items/textures/item/my_armor/chestplate.png
Animated textures
You can also create animated armors!
To create an animated armor you have to create an image with all the animation frames. Each frame must be under the previous. This is an example this is a 3 frames animation:
Now let's edit the rendering properties to support the animation.
In this case I set interpolation: true because I want the animation to be smooth.
Default speed is 24, but you can customize it until you find the right speed value:
Emissive textures (glowing in the dark)
You can also create emissive textures which glow in the dark. (You can make both animated and emissive textures at the same time!)
In this case I want to make the previous animation emissive, I want it to glow in the dark. You have to make 2 textures in order to make the textures glow. The transparent part won't glow while the colored part will glow.
You basically just have to copy and paste your texture and erase the parts you don't want to glow.
Extra: Custom 3D helmet
Currently only items equipped on the head support 3D due to Minecraft limitations.
This is an example on how to create a custom helmet that has a 3D model and not just a texture.
Make sure to use a material like PAPER and not an helmet, otherwise the 3D model would not be visible when equipped.
Custom helmets support durability only on ItemsAdder 4.0.8+.
Full configuration from the previous example
contents folder of ItemsAdderFAQ
armors_rendering was renamed to legacy_armor_renderings in ItemAdder 4.0.9.
The old property still works to maintain compatibility.
This is a simple armor which is created automatically without textures, ItemsAdder will generate it from the color you decided and will be similar to iron/diamond armors but with different color.
Creating an armor piece
Let's create a chestplate.
To create other pieces you just have to repeat the following method and change the slot.
The color property is important, it's the color that the armor will have ingame.
Done!
Nothing more to do. You just created a simple armor without drawing any texture!
Full configuration from the previous example
contents folder of ItemsAdderLast updated