Equipment Generator - Faith-and-Code-Technologies/mDirt GitHub Wiki

Items

This page explains how to use the Item generator in mDirt to add custom items to your Minecraft datapack.


Creating a New Item

  1. In the Menu Bar, go to New Element → Item
  2. The main area will update with fields for configuring your item.

Core Fields

Display Name

  • The user-facing name of the armor set (e.g., Emerald)

Name

  • The internal ID of the armor set (e.g., emerald)
  • Must be:
    • All lowercase
    • No spaces
    • Use underscores (_) to separate words

Armor Stats

Helmet / Chestplate / Leggings / Boots Armor

  • The armor points for each specific piece in the set

Armor Toughness

  • Sets how resistant the armor is to strong attacks
  • Common values range from 0–3

Knockback Resistance

  • Percentage of knockback prevented when wearing the full set
  • Ranges from 0.0 (none) to 1.0 (fully immune)

Durability (Chestplate)

  • The durability value for the chestplate
  • Other pieces are automatically calculated based on this:
Piece % of Chestplate Formula
Helmet 68.75% chestplate * 0.6875
Leggings 93.75% chestplate * 0.9375
Boots 81.25% chestplate * 0.8125

Durability Reference (Vanilla Sets)

Armor Set Chestplate Durability
Leather 80
Golden 112
Chainmail 240
Iron 240
Diamond 528
Netherite 592

Item Textures

Used in inventory screens and tooltips.

  • Helmet Texture
  • Chestplate Texture
  • Leggings Texture
  • Boots Texture

Must be .png files. Suggested sizes: 16x16, 32x32, or 64x64.


Model Textures

Rendered on the player model in-game.

  • humanoid Texture — for Helmet, Chestplate, and Boots
  • humanoid_legs Texture — for Leggings

Horse Armor (Optional)

To include horse armor in the set:

Include Horse Armor?

  • Toggle to add or exclude horse armor.

If enabled:

  • Horse Armor Item Texture — shown in inventory
  • Horse Armor Model Texture — renders on the horse
  • Horse Armor — defines armor protection level (numeric)