Custom Items

Creating Items That Soldiers Can Hold

To create items that soldiers can hold, you need to modify the soldier_holdable.json file.

└─ data
   └─ (your data pack name)
      └─ data-maps
        └─ item
           └─ soldier_holdable.json

Here's the basic structure:

{
  "values": {
    "modid:item_name": {            // For Vanilla Minecraft Items ModId is 'minecraft'
      "properties": {
        ...
      },
      "slot": name,                 // Defines which slot the item is held in (e.g., mainhand or offhand)
      "pick_priority": number,      // (Optional) Determines priority when soldiers pick up items
      "drop_rate": number,          // (Optional) Chance that the soldier will drop the item on death
      "predicate": test,            // (Optional) Conditions under which the item can be held
      "on_pick": [
        functions...                // (Optional) Define custom functions for when the item is picked up 
      ]
      "removal_condition": {        // (Optional) Define custom conditions for when the item is destroyed
        ...
      }
    },
    ...
  }
}

Important

Ensure that your item is added to the "clay_soldier_holdable" tag, otherwise soldiers won’t pick up the item.

Putting your item under the "clay_soldier_weapon" tag, makes them swing it on attack.

Info

More details on properties and values, can be found here.

Example: Adding a Stick

Let's look at an Example. If we want soldiers to hold a stick and deal extra damage, we can define it like this:

{
  "values": {
    "minecraft:stick": {
      "properties": {
        "csr:damage": 2.0 // Increases the soldier's damage when holding a stick
      },
      "slot": "mainhand" //  The stick should be held in the main hand only 
      // We dont need to mention other values as we want to leave as the default value
    },
    // Some other items...
  }
}

Tips

You can find more examples of items implemented by the Clay Soldiers mod for inspiration.

Creating Items That Soldiers Can Wear

To create wearable items, modify the soldier_wearable.json file.

└─ data
   └─ (your data pack name)
      └─ data-maps
        └─ item
           └─ soldier_wearable.json

Important

This is only visual, all properties like protection, should be added via Holdable Items

Here's the basic structure:

{
  "values": {
    "armor": {
      "slot": {
        "model": id     // (Optional) The id of the armor model
        "color": color  // (Optional) The color model. 
        "trims: [
            ...         // (Opional) List of trims to apply
        ]
      }
    },
    "accessories": {
      ...
    }
  },
  ...
}

Example

Let's look at how we could make a Gold Ingot acts as helmet. First we create a Holdable Item, also don't forget to tag the Item:

Details

"minecraft:gold_ingot": {
  "properties": {
    "protection": 1.0
  },
  "slot": "head"
}

Now we make the visuals for the item. We modify the soldier_wearable.json

{
  "values": {
    "minecraft:gold_ingot": {
      "armor": {
        "head": { // <- The Slot this Item acts as Armor
          "model": "minecraft:golden_helmet" // The armor model we want to copy
        }
      }  
    },
    ...
  }
}

You can specify other Slots such as head, chest, legs, feet. An item can even be worn in multiple slots by adding multiple entries: Additionally we can also color armor pieces

"armor": {
  "chest": {
    "model": "minecraft:leather_chestplate",
    "color": "#1D1D21" // RGB color
  },
  "feet": {
    "copy_model": "minecraft:leather_boots",
    "color": 1908001 // RGB color in integer format, same as (RGB 1D1D21)
  }
}

Info

Learn more about Color here

Adding Armor Trims

You can also add trims to armor pieces:

Suit

"chest": {
  model": "minecraft:chainmail_chestplate",
  "trims": [
    {
      "material": "minecraft:gold",
      "pattern": "minecraft:shaper"
    },
    {
      "material": "minecraft:gold",
      "pattern": "minecraft:vex",
    }
  ],
}

Glasses

"head": {
  "model": "minecraft:iron_helmet",
  "trim_only": true, // When set to true the armor copy will not be displayed
  "trims": [
    {
      "material": "minecraft:quartz",
      "pattern": "minecraft:eye"
    },
    {
      "material": "minecraft:netherite",
      "pattern": "minecraft:spire"
    }
  ]  
}

Creating an Accessory

Accessories are visually displayed items that are not considered armor, such as capes.

Cape

"minecraft:rabbit_hide": {
  "accessories": {
    "cape": {
      "texture_location": "csr:textures/entity/clay_soldier/paper_cape.png",
      "color": 8339378 // Optionally we could add a color.
    }
  }
}

Skull

"minecraft:skeleton_skull": {
  "accessories": {
    "skull": {
      "item": "minecraft:skeleton_skull"
    }
  }
}

Snorkel

"accessories": {
  "snorkel": "csr:textures/entity/clay_soldier/bamboo_stick.png" // <- Texture of the Snorkel
}

Shield

"accessories": {
  "shield": "csr:textures/entity/clay_soldier/clay_shield.png"
}

Glider

"accessories": {
  "glider": "minecraft:rabbit_hide" // <- the Item we use as a Glider
}

Wrapped

"accessories": {
  "string": "csr:textures/entity/clay_soldier/wrapped.png"
}