Skip to content
tterrag edited this page Jul 8, 2016 · 12 revisions

Armor is easily one of the most complex items in the game. Vanilla doesn't have much depth to its armor, so the options working with vanilla armor are rather limited. Custom Things gives you the ability to customize every small part of your armor, down to the last number.

There are three main numbers that affect the formula of how much damage to block. These are:

  • Protection ratio: The amount of protection this piece of armor contributes to the total protection (a number from 0-1). For example, if you wear one armor piece with a ratio of 1.0, it will only block 25% of the damage being delt.
  • Protection max: The amount of protection this armor can block. Any amount of damage absorbed over this number will bypass armor.
  • Protection priority: This determines the priority of how the damage is split among armor pieces. If an armor piece has a higher priority it will be allowed to absorb more than its default share of damage.

All arrays are size 4, with the exception of "armors" which can be size 1-4. They match up with the type of the armor (3 - boots, 2 - legs, 1 - chest, 0 - helm). The unused slots can be filled with a value of 0.

The item icons will have to be named in the following convention, where "name" is replaced with the actual item name as named in the "name" field: nameBoots.png, nameLegs.png, nameChest.png, nameHelm.png. Skin textures are name1.png and name2.png.

Field Name Type Description Default
armors Integer Array The armor types to register. An array of 4 numbers from 0-3 representing the armor pieces to add to the game. [0, 1, 2, 3]
durabilities Integer Array Durability of each armor type. Represents the exact number of times this armor can absorb damage before it breaks. [100, 400, 500, 150]
protectionDisplays Integer Array The amount of armor symbols (in halves of symbols) to display as the protection of each piece. [1, 2, 3, 1]
protectionRatios Integer Array The ratios for the protection of each piece. See above definition for protection ratios. [0.1, 0.1, 0.1, 0.1]
protectionMaxes Integer Array The max amount of damage each piece can absorb. See above definition for protection maxes. [5, 15, 20, 7]
priorities Integer Array The priority of each piece. See above definition for priorities. [0, 0, 0, 0]
enchantability Integer The enchantability of the armor set. 15
material String The repair material of this tool. A custom itemstack. "null"

Example

{"data": [
    {   
        "name": "nanosuit",
        "durabilities": [100,200,300,400],
        "protectionDisplays": [2,2,2,2],
        "protectionRatios": [1,1,1,1],
        "protectionMaxes": [20,20,20,20],
        "enchantability": 0,
    }
]}

Textures

For the model textures, use the vanilla armors as an example. name1.png is the upper part of the skin (Chest, Arms and Head), name2.png is the bottom part of the skin (Legs and Boots).

Clone this wiki locally