item Creation

ShopMaster Item Creation Guide

This guide will help you understand how to create and configure items in your ShopMaster shops. The plugin offers extensive customization options for various item types.

Basic Item Structure

Each item in a shop is defined by a unique ID under the items section. Here's the basic structure:

shopName:
  items:
    1:  # Item ID (must be unique)
      item:
        material: DIAMOND_SWORD  # Minecraft item material
        quantity: 1              # Amount of items
        name: "&bMagic Sword"    # Display name (supports color codes)
        lore:                    # Item description
          - "&7A powerful sword"
          - "&7that deals extra damage"
      page: 1                    # Page where this item appears
      slot: 10                   # Inventory slot position
      economy: VAULT             # Economy type (VAULT, TOKENS, etc.)
      buyPrice: 100              # Price to buy from shop (-1 to disable)
      sellPrice: 50              # Price to sell to shop (-1 to disable)

Slot Configuration

ShopMaster offers flexible slot configuration:

Single Slot

slot: 10  # Places item in slot 10

Multiple Slots

slots:
  - 10
  - 11
  - 12

Range of Slots

slot: "10-15"  # Places item in slots 10 through 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

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

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

Special Items Configuration

Potions

item:
  material: POTION  # or SPLASH_POTION, LINGERING_POTION
  potion:
    type: STRENGTH  # Potion type
    extended: true  # Extended duration
    upgraded: false # Amplified effect (level II)
    custom_effects:
      1:
        type: REGENERATION
        duration: 200
        amplifier: 1

Spawners

item:
  material: SPAWNER
  mob: ZOMBIE  # Mob type for the spawner

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  # Flight duration
    effects:
      1:
        type: BALL_LARGE  # Effect type
        flicker: true     # Twinkle effect
        trail: true       # Trail effect
        colors:
          - "255,0,0"     # RGB colors
          - "0,255,0"
        fade_colors:
          - "0,0,255"

Colored Armor

item:
  material: LEATHER_CHESTPLATE
  armor_color: "255,0,0"  # RGB color

Armor Trim

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

Tipped Arrows

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

Crossbow 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  # Axolotl variant (LUCY, BLUE, GOLD, etc.)

Hidden Items

You can create hidden items that only appear for players with specific permissions:

item:
  material: NETHERITE_SWORD
hidden: true  # Not visible in menu

Additional Options

Item Restrictions

Control which items can be sold to your shop in the config.yml file.

Multiple Economies

Support for various economy types:

• VAULT: Server money

• TOKENS: TokenManager integration

• POINTS: PlayerPoints integration

Custom Item Support

Compatible with custom items from:

• MMOItems

• ItemsAdder

• Oraxen

• ExecutableItems

• BreweryX (custom potions)

Example Complete Item

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!"

Remember to reload the plugin with /adminshop reload after making changes to your shop configuration files.