Basic Item Format

Define all your custom items in a single customs.yml per namespace under plugins/CoreItems/customs/<namespace>/customs.yml. Each item entry follows this structure:

---

1. Entry Key

• What it is: The unique identifier for your item.

• How it’s used: Refer to it as <namespace>:<item_key> when giving or scripting.

---

2. Required Fields

• material The vanilla Minecraft material type (e.g., DIAMOND_SWORD, BOOK).

• name The display name shown to players. Supports color codes (e.g., &c&lFlame Sword).

---

3. All Configurable Fields

Field	Description
lore	Lines of descriptive text under the name.
custom_model_data	Resource-pack model ID for custom textures.
unbreakable	Whether the item never loses durability.
hide-attributes	Hides default attribute tooltips (attack damage, speed, etc.).
glowing	Adds the enchantment “glint” effect without real enchants.
is_enchanted	Similar to glowing, adds an enchant glint.
enchantments	Vanilla enchantments and levels (e.g., SHARPNESS: 5).
item-flags	Minecraft item flags (e.g., HIDE_ATTRIBUTES, HIDE_ENCHANTS).
cooldown	Per-item interaction cooldown in milliseconds (overrides global setting).
left_click_command	Console command run when player left-clicks the item. Supports placeholders like %player%.
right_click_command	Console command run on right-click.
cancel_left_click	Prevents normal left-click behavior (e.g., breaking blocks).
cancel_right_click	Prevents normal right-click behavior (e.g., placing blocks).
cooldown	Item-specific cooldown in milliseconds (overrides global cooldown in config.yml)
cooldown-message	Custom message to show when item is on cooldown (overrides global message)
cooldown-message-interval	Number of messages to send during cooldown period (overrides global setting)
droppable	Configure if the item is droppable.
show-item-cooldown	Configure if the item should show a visible cooldown effect in the items hotbar slot when on cooldown.

---

4. Full Example

magic_wand:
  material: BLAZE_ROD
  name: "&5&lMagic Wand"
  lore:
    - "&7A wand imbued with arcane energy."
    - "&7Right-click to cast a fireball."
  amount: 1
  custom_model_data: 2001
  unbreakable: true
  hide-attributes: true
  glowing: true
  enchantments:
    DURABILITY: 10
  item-flags:
    - HIDE_ATTRIBUTES
    - HIDE_ENCHANTS
  cooldown: 3000
  left_click_command: "particle flame ~ ~1 ~ 0.5 0.5 0.5 0.1 20"
  right_click_command: "execute as %player% run summon fireball ~ ~1 ~ {ExplosionPower:2}"
  cancel_left_click: true
  cancel_right_click: true

---

Next: Proceed to the Namespace System page to learn how to organize multiple customs.yml files into logical groups (namespaces).