item Creation

This section is a complete guide explaining how to create and configure items in stores using the plugin.

🛒 ShopMaster - Item Creation Guide

This guide explains how to create and configure items for your shops using the ShopMaster plugin. It includes detailed examples and advanced customization options for various item types.

---

📦 Basic Item Structure

Each item is defined under a unique ID within a specific shop section.

<shopName>:
  items:
    1:  # Unique item ID
      item:
        material: DIAMOND_SWORD       # Minecraft material
        quantity: 1                   # Number of items
        name: "&bMagic Sword"         # Display name (supports color codes)
        lore:                         # Item description
          - "&7A powerful sword"
          - "&7that deals extra damage"
      page: 1                         # Shop GUI page number
      slot: 10                        # Inventory slot position
      economy: VAULT                 # Economy type (e.g., VAULT, TOKENS)
      buyPrice: 100                  # Buy price (-1 to disable)
      sellPrice: 50                  # Sell price (-1 to disable)

---

🎯 Slot Configuration

ShopMaster supports flexible slot placement:

Single Slot

slot: 10

Multiple Slots

slots:
  - 10
  - 11
  - 12

Slot Range

slot: "10-15"

Mixed Format

slots:
  - "10-15"
  - 20
  - "22-24"

---

✨ Advanced Item Features

Enchantments

item:
  enchantments:
    SHARPNESS: 5
    UNBREAKING: 3

Item Flags

item:
  flags:
    - HIDE_ATTRIBUTES
    - HIDE_ENCHANTS

---

💰 Buy/Sell Commands

Run commands when a player buys or sells an item:

Buy Commands

buy_commands:
  - "[command] give %player_name% diamond 5"
  - "[command] broadcast %player_name% bought a special item!"

Sell Commands

sell_commands:
  - "[command] eco give %player_name% 100"
  - "[command] say %player_name% sold an item!"

---

🧪 Special Item Configurations

Potions

item:
  material: POTION
  potion:
    type: STRENGTH
    extended: true
    upgraded: false
    custom_effects:
      1:
        type: REGENERATION
        duration: 200
        amplifier: 1

Spawners

item:
  material: SPAWNER
  mob: ZOMBIE

Banners

item:
  material: WHITE_BANNER
  banner:
    patterns:
      1:
        pattern: BORDER
        color: BLACK
      2:
        pattern: SKULL
        color: RED

Firework Rockets

item:
  material: FIREWORK_ROCKET
  firework:
    power: 3
    effects:
      1:
        type: BALL_LARGE
        flicker: true
        trail: true
        colors:
          - "255,0,0"
          - "0,255,0"
        fade_colors:
          - "0,0,255"

Colored Armor

item:
  material: LEATHER_CHESTPLATE
  armor_color: "255,0,0"

Armor Trim

item:
  material: DIAMOND_HELMET
  trim:
    pattern: DUNE
    material: GOLD

Tipped Arrows

item:
  material: TIPPED_ARROW
  arrow_potion:
    type: POISON
    extended: true
    upgraded: false
    custom_effects:
      1:
        type: SLOWNESS
        duration: 200
        amplifier: 1

Crossbows with Loaded Projectiles

item:
  material: CROSSBOW
  loaded_projectiles:
    1:
      material: TIPPED_ARROW
      quantity: 1
      potion:
        type: INSTANT_DAMAGE
        extended: false
        upgraded: true

Axolotl Buckets

item:
  material: AXOLOTL_BUCKET
  axolotl:
    variant: BLUE

---

🙈 Hidden Items

You can create items that are only visible to players with specific permissions:

item:
  material: NETHERITE_SWORD
hidden: true

---

⚙️ Additional Options

Item Restrictions

You can restrict which items can be sold to the shop using the config.yml file.

Multiple Economies

ShopMaster supports various economy systems:

Type	Description
VAULT	Default money system
TOKENS	Integration with TokenManager
POINTS	Integration with PlayerPoints

---

🧩 Custom Item Support

ShopMaster is compatible with custom items from popular plugins such as:

• MMOItems

• ItemsAdder

• Oraxen

• ExecutableItems

• BreweryX (for custom potions)

---

🧪 Complete Example

shops:
  weapons:
    items:
      1:
        item:
          material: DIAMOND_SWORD
          quantity: 1
          name: "&b☆ Frost Blade ☆"
          lore:
            - "&7A legendary sword forged in"
            - "&7the depths of an ice cavern"
          enchantments:
            SHARPNESS: 5
            FIRE_ASPECT: 2
          flags:
            - HIDE_ATTRIBUTES
        page: 1
        slot: 13
        economy: VAULT
        buyPrice: 5000
        sellPrice: 2500
        buy_commands:
          - "[command] tell %player_name% You've purchased the legendary Frost Blade!"

---

🔁 Reloading Changes

After editing your shop configuration files, reload the plugin with the following command:

/adminshop reload