Villagers Shop

Similar to the shopkeeper system

Overview

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

It is recommended to use this website to create items with custom lores, names, enchantments, flags, and more.

Menu Title

Title: Swords

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

Items Configuration

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:

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.

---

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