Item Configuration Guide

This section explains how to configure custom items in Better Build. Each item supports various properties like custom names, lore, enchantments, and textures.

Basic Fields

material

The type of material for the item. Use a valid Minecraft Material name.

• Default: STONE

• Example: DIAMOND_SWORD

displayName

The custom name displayed for the item. Supports color codes (e.g., &6Golden Sword).

• Default: &fDefault Item

• Example: &aSpecial Sword

amount

The number of items in the stack.

• Default: 1

• Example: 64

lore

A list of strings representing the item's description. Each line is a separate string. Example:

yamlCopyEditlore:
  - "&7This is a special item."
  - "&eUse it wisely!"

---

Optional Fields

textureURL (For custom-textured items like player heads)

Defines a custom texture URL.

• Default: "" (no texture)

• Example: http://textures.minecraft.net/texture/...

enchantments

A list of enchantments applied to the item. Use valid enchantment names. Example:

yamlCopyEditenchantments:
  - SHARPNESS
  - FIRE_ASPECT

itemFlags (Hide specific item properties)

A list of item flags to hide attributes like enchantments or durability. Example:

yamlCopyEdititemFlags:
  - HIDE_ATTRIBUTES
  - HIDE_ENCHANTS

glow (Adds a glowing effect without enchantments)

• Default: false

• Example: true

durability (Sets the item's durability)

• Default: 0 (no durability applied)

• Example: 100

bannerPatterns (For banners, define patterns using color and type)

Example:

yamlCopyEditbannerPatterns:
  - RED_CROSS
  - BLACK_BORDER

---

Example Configuration

A fully defined item in the configuration file:

yamlCopyEditItem:
  material: "DIAMOND_SWORD"
  displayName: "&6Legendary Sword"
  amount: 1
  lore:
    - "&7A weapon of legends."
    - "&cHandle with care."
  textureURL: "http://textures.minecraft.net/texture/..."
  enchantments:
    - SHARPNESS
    - UNBREAKING
  itemFlags:
    - HIDE_ENCHANTS
    - HIDE_ATTRIBUTES
  glow: true
  durability: 1561
  bannerPatterns:
    - RED_CROSS
    - WHITE_BORDER

---

Key Features of Custom Items

1. Enchantments

   • Add enchantments by listing them in the enchantments field.

   • Enchantments are case-insensitive.

2. Custom Textures

   • Use the textureURL field to apply player head textures.

3. Banner Patterns

   • Define patterns using bannerPatterns (e.g., RED_CROSS).

4. Glow Effect

   • Enable the glow field to add a glowing effect without enchantments.

5. Item Flags

   • Hide specific properties like enchantments or attributes using itemFlags.

---

Advanced Example (Banner Configuration)

yamlCopyEditItem:
  material: "WHITE_BANNER"
  displayName: "&bCustom Banner"
  amount: 1
  lore:
    - "&7A unique banner with custom patterns."
  bannerPatterns:
    - BLUE_STRIPE_DOWNLEFT
    - RED_CIRCLE
  itemFlags:
    - HIDE_DYE