# Merchant config

{% hint style="danger" %}
Eco plugins (EcoItems, EcoArmor etc) is not supported here! You can use them for results but you will encounter visible glitches if you use them as ingredients. (It will still work, but until you take out the result item it will be displayed as air/nothing). This is due to how Eco handles items and client side item lore in general (most likely at least).
{% endhint %}

```yaml
merchants:
  # The key is the id of the merchant (used in commands)
  test:
    # Name of the merchant
    name: "Test Merchant"
    # Permission required to use the merchant (Optional)
    permission: "test.permission"
    # Menu item in the global merchant menu
    menu:
      title: "{name}"
      # Replace the lore if the merchant is locked
      locked-lore:
        - "&7Unlock this merchant by"
        - "&7completing &aDiamond collection V&7!"
      item:
        material: emerald
        name: "&a{name}"
        slot: 10
        lore:
          - "&7Click to open the merchant"
    # Offers that the merchant has
    offers:
        # Ingredient items are defined the same way as in recipes.
      - ingredients:
          - "minecraft:cobblestone/64"
          - "minecraft:coal/7"
        # Offer result is defined the same way as in recipes
        result: "mythicmobs:my_item/1"
        # Permission to view and use this offer. (Optional)
        permission: "test.merchant.offer.1"
```


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.auroramc.gg/auroracrafting/configuration/merchant-config.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
