> For the complete documentation index, see [llms.txt](https://luxurydev.gitbook.io/luxry-club/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://luxurydev.gitbook.io/luxry-club/resources/skymines/villagers-shop.md).

# 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 |