🍎How to create Items

SettingsPlus allows you to create highly customizable items for your menus. These items can include custom materials, names, lore, enchantments, and more. Below is a detailed guide on how to define items in your configuration files.

Configuration Fields

To define an item in your configuration, include the following fields:

Required 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. Use 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 lore (description) of the item. Each line is a separate string.

  • Example:

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

---

Optional Fields

• textureURL: A custom texture URL for items that support custom textures (like player heads).

  • Default: "" (no texture)

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

• enchantments: A list of enchantments to apply to the item. Use valid enchantment names.

  • Example:

    enchantments:
      - SHARPNESS
      - FIRE_ASPECT

• itemFlags: A list of item flags to hide certain item properties (e.g., enchantments, attributes). Use valid ItemFlag names.

  • Example:

    itemFlags:
      - HIDE_ATTRIBUTES
      - HIDE_ENCHANTS

• glow: Adds a glowing effect to the item without requiring enchantments.

  • Default: false

  • Example: true

• durability: Sets the durability of the item.

  • Default: 0 (no durability applied)

  • Example: 100

• bannerPatterns: For banner items, defines a list of patterns. Each pattern consists of a color and a pattern type separated by an underscore (_).

  • Example:

    bannerPatterns:
      - RED_CROSS
      - BLACK_BORDER

---

Example Configuration

Here’s a full example of how to define an item in your configuration file:

Item:
  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 to your items by listing their names in the enchantments field. Enchantments are case-insensitive.

2. Custom Textures

Use the textureURL field to apply custom textures, such as for player heads.

3. Banner Patterns

For banners, define patterns using bannerPatterns. Patterns consist of a color (e.g., RED) and a type (e.g., 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 with itemFlags.

---

Advanced Item Example (Banner)

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