# item Creation

🛒 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.

```yaml
<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

```yaml
slot: 10
```

### Multiple Slots

```yaml
slots:
  - 10
  - 11
  - 12
```

### Slot Range

```yaml
slot: "10-15"
```

### Mixed Format

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

***

## ✨ Advanced Item Features

### Enchantments

```yaml
item:
  enchantments:
    SHARPNESS: 5
    UNBREAKING: 3
```

### Item Flags

```yaml
item:
  flags:
    - HIDE_ATTRIBUTES
    - HIDE_ENCHANTS
```

***

## 💰 Buy/Sell Commands

Run commands when a player buys or sells an item:

### Buy Commands

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

### Sell Commands

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

***

## 🧪 Special Item Configurations

### Potions

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

### Spawners

```yaml
item:
  material: SPAWNER
  mob: ZOMBIE
```

### Banners

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

### Firework Rockets

```yaml
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

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

### Armor Trim

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

### Tipped Arrows

```yaml
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

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

### Axolotl Buckets

```yaml
item:
  material: AXOLOTL_BUCKET
  axolotl:
    variant: BLUE
```

***

## 🙈 Hidden Items

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

```yaml
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

```yaml
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:

```bash
/adminshop reload
```


---

# 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.xshyo.us/premium-plugins/shopmaster/item-creation.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.