Adding Items

To add an item that can be colored in the free-colored menu, it must be defined in the menus.yml file within a special items section.

Step 1: Open the menus.yml file

All settings are configured in the plugins/ECosmetics/menus.yml file.

Step 2: Find or create the items section

In the menus.yml file, there must be a section named items. Inside this section, you create a block with an ID that will contain your items.

By default, this block already exists and is named contain-item.

Step 3: Add items to the block

Inside the contain-item block, add the configuration for each item you want to paint in the coloring menu.

Example:

items:
  contain-item: # The ID of the group the menu will reference
    magic_helmet: # Your unique ID for this item
      display: '&bMagic Helmet'
      material: LEATHER_HORSE_ARMOR # The material must be dyeable
      lore:
        - '&7Click to color'
      modeldata: 20001
      
    magic_boots: # A second item for the example
      display: '&eMagic Boots'
      material: LEATHER_BOOTS
      lore:
        - '&7Click to color'
      modeldata: 20002

Step 4: Ensure the menu references this block

In your free-colored menu configuration, there must be a line contains-item: contain-item. This indicates that the items from the contain-item block should be displayed in the slots of this menu.

free-colored:
    title: '&f:b10::cmenu2: '
    size: 6
    type: FREE_COLORED
    # ... slots and other settings ...
    contains-item: contain-item # <-- This line links the menu to your items

Step 5: Reload the plugin

Execute the command to apply the changes:

/ecosmetics reload