# Villagers Shop

<details>

<summary>Overview</summary>

&#x20;                                      <img src="/files/jFlWzgGfizkQhPI6ne1T" alt="" data-size="original">

</details>

You can start by browsing `plugins/SkyMines-Core/Menus`. By default, you'll find the "Swords" category.

It is recommended to use this [website](https://www.gamergeeks.net/apps/minecraft/give-command-generator) to create items with custom lores, names, enchantments, flags, and more.

#### Menu Title

```yaml
Title: Swords
```

It is recommended to use the `/editmenu` command in-game to access additional editing options.

#### Items Configuration

```yaml
Items:
  '0':
    type: DIAMOND_SWORD
    amount: 1
    display-name: "§x§E§C§D§3§2§D§lEXAMPLE SWORD §7[I]"
    lore:
      - "§7Enchanted Sword§5"
      - "§x§8§E§5§E§E§D§lENCHANTMENTS:§5"
      - "§x§8§E§5§E§E§DFire Aspect I"
      - "§x§8§E§5§E§E§DSharpness I§5"
      - "§x§5§E§7§D§E§D§lINFORMATION:§x§5§E§7§D§E§D8 Attack Damage"
      - "§x§5§E§7§D§E§DHex colors support!"
    enchantments:
      - FIRE_ASPECT:1
      - DAMAGE_ALL:1
    flags:
      - HIDE_ENCHANTS
      - HIDE_ATTRIBUTES
    price:
      FirstItem:
        type: DIAMOND
        amount: 1
  '1':
    type: DIAMOND_SWORD
    amount: 1
    display-name: "§x§E§C§D§3§2§D§lUPGRADABLE EXAMPLE SWORD §7[II]"
    lore:
      - "§7Enchanted Sword"
      - "§7Requires the previous sword to upgrade§5"
      - "§x§8§E§5§E§E§D§lENCHANTMENTS:§5"
      - "§x§8§E§5§E§E§DFire Aspect II"
      - "§x§8§E§5§E§E§DSharpness II§5"
      - "§x§5§E§7§D§E§D§lINFORMATION:§x§5§E§7§D§E§D8.5 Attack Damage"
      - "§x§5§E§7§D§E§DItem Flags Supported!"
    enchantments:
      - FIRE_ASPECT:2
      - DAMAGE_ALL:2
    flags:
      - HIDE_ENCHANTS
      - HIDE_ATTRIBUTES
    price:
      FirstItem:
        type: DIAMOND_SWORD
        display-name: "§x§E§C§D§3§2§D§lEXAMPLE SWORD §7[I]"
        amount: 1
        enchantments:
          - FIRE_ASPECT:1
          - DAMAGE_ALL:1
      SecondItem:
        type: DIAMOND
        amount: 2
  '2':
    type: DIAMOND_SWORD
    amount: 1
    display-name: "§x§E§C§D§3§2§D§lUPGRADABLE EXAMPLE SWORD §7[III]"
    lore:
      - "§7Enchanted Sword"
      - "§7Requires the previous sword to upgrade§5"
      - "§x§8§E§5§E§E§D§lENCHANTMENTS:§5"
      - "§x§8§E§5§E§E§DFire Aspect III"
      - "§x§5§E§7§D§E§D§lINFORMATION:§x§5§E§7§D§E§D9 Attack Damage"
      - "§x§5§E§7§D§E§DCan be edited via /editmenu <name> <page>"
    enchantments:
      - FIRE_ASPECT:2
      - DAMAGE_ALL:3
    flags:
      - HIDE_ENCHANTS
      - HIDE_ATTRIBUTES
    price:
      FirstItem:
        type: DIAMOND_SWORD
        display-name: "§x§E§C§D§3§2§D§lUPGRADABLE EXAMPLE SWORD §7[II]"
        amount: 1
        enchantments:
          - FIRE_ASPECT:2
          - DAMAGE_ALL:2
      SecondItem:
        type: DIAMOND
        amount: 3
```

***

#### Example Trade Format

Here’s an example of how to structure a custom trade:

```yaml
Example-Trade: # This is the trade name used in-game
  type: DIAMOND     # The resulting item type
  amount: 2         # The amount of the resulting item
  price:
    FirstItem: ...  # First required item
    SecondItem: ... # Second required item
```

You can define the resulting item at the root level and specify the required items under the `price` section.

***

We also provide an in-game shop editor. You can use the `/em` or `/editmenu <shop-name> <page>` command to freely edit the shop as you like. This allows you to add enchanted items, items with custom names, and more.

<figure><img src="/files/GMCJeUS6VFO79dX42DBg" alt="" width="255"><figcaption></figcaption></figure>

***

| commands                       | permissions               |
| ------------------------------ | ------------------------- |
| /shop \<menu-name>             | No permission needed      |
| /editmenu \<menu-name> \<page> | skymines.command.editmenu |


---

# 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.luxry.club/resources/skymines/villagers-shop.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.