Dye (HMCColor Integration)

The FurnitureShow plugin integrates with the HMCColor plugin to allow players to dye certain furniture items. This functionality is conditional and will only work if HMCColor is properly installed and enabled in FurnitureShow's configuration.

---

Requirements and Configuration

For the dye functionality to be active, you must ensure two main conditions are met:

1. HMCColor Plugin Installation:

   • The HMCColor plugin must be installed on your server.

   • Make sure it is compatible with your server version.

2. FurnitureShow config.yml Setup: You need to enable HMCColor integration within FurnitureShow's config.yml file and define which materials are considered dyeable

#Required HMCColor
hmc-color:
  enabled: true
  gui:
    dye-menu-input-slot: 10  # Slot for the furniture item to be dyed
    dye-menu-output-slot: 16 # Slot for the resulting furniture item
    material-dyeable:        # List of items that can be dyed
    - LEATHER_HORSE_ARMOR

---

How Dye Functionality Works

Once HMCColor is enabled and configured:

1. Dyeable Item Identification:

   • The plugin identifies items as "dyeable" if their base Minecraft Material is present in the material-dyeable list in config.yml.

2. Searching for Dyeable Items:

   • Players can use the /nwfurnitureopen search <keyword> [category] dye command to specifically filter results to show only dyeable furniture. This is explained in more detail in the Search Functionality section.
3. Dyeing Process (via HMCColor GUI):

   • When a player obtains a dyeable furniture item, they can use HMCColor's own commands or methods to open the dyeing GUI.

   • They place the furniture item into the dye-menu-input-slot and the desired dye into another HMCColor-defined slot.

   • The resulting dyed furniture item will appear in the dye-menu-output-slot

---

Note: The FurnitureShow plugin identifies which items can be dyed, making it easier to find them and displaying the dyed items in the plugin’s preview. The actual process of dyeing the items is handled by the HMCColor plugin, which is required to make this work.