# Setting Items

### Item Configurating

```yaml
# If you want to use custom skull skin in items, you need to make like this:
# material: SKULL_ITEM (or PLAYER_HEAD in 1.13+)
# data: 3 (If 1.13+ write 0)
# skull: hdb-100 (For HeadDatabase)
# skull: skin value (For custom skull skin)
items: # Item Setting in items.yml
  COBBLESTONE: # Item's name for groups or buy & sell command.
    material: COBBLESTONE # Item's material. [REQUIRED]
    group: COBBLESTONE_PRODUCTS # Item's group for groups menu. (OPTIONAL)
    category: mining # Item's category for main menu. [REQUIRED]
    data: 0 # Material data for items like glass or clay. (OPTIONAL)
    prices: # Default buy & sell prices [REQUIRED]
      buy: 2.0
      sell: 1.0
    max_prices: # Maximum buy & sell prices for item. Item can't pass this prices. (OPTIONAL)
      buy: 200.0
      sell: 100.0
    name: 'Cobblestone' # Item's name [REQUIRED]
    color: '&f' # Color for item name, example item name etc. (OPTIONAL)
    durability: 100 # For items like pickaxe, sword. (OPTIONAL)
    placeable: true # If it's false, you can't place this block to ground. (OPTIONAL)
    lore: # Item's lore (OPTIONAL)
      - '&f&lCOMMON'
    enchants: # Item's enchants (OPTIONAL)
      - DURABILITY:10 # ENCHANT:LEVEL
    flags: # Item's flags (OPTIONAL)
      - HIDE_ENCHANTS # Will hide enchant names in lore.
    tags: # You can add NBT tags for item. (OPTIONAL)
      - ItemType:Special # Tag:String
    normal: true # If it's true, you will get normal item without lore, name, enchants etc. (OPTIONAL)
    stock: true # If it's true, you can only buy or sell maximum by total orders' count. (OPTIONAL)
    # You can add item or click commands too. (OPTIONAL)
    # Usage: "type:command" (Types: console, player)
    # Placeholders: %player%, %uuid%
    item_commands:
      buy: # Commands when you buy item.
        - "console:say %player% you bought item!"
      sell: # Commands when you sell item.
        - "console:say %player% you sold item!"
    click_commands:
      left: # Commands when you left click to item.
        - "console:say %player% you left click to item!"
      right: # Commands when you right click to item.
        - "console:say %player% you right click to item!"
    model: 192031 # Custom model data for 1.14+. (OPTIONAL)
    disableNBT: true # You can disable BazaarITEM nbt. (OPTIONAL)
    disableNAME: true # You can disable item's display name so it can be default Minecraft item name. (OPTIONAL)
```

### Category Configurating

```yaml
categories: # Category Setting in items.yml
  mining: # Category name for items etc.
    glass: 5 # Glass data for main glasses. (OPTIONAL)
    material: DIAMOND_PICKAXE # Category's item material. [REQUIRED]
    data: 0 # Material data for items like glass or clay. (OPTIONAL)
    name: "Mining" # Category's name. [REQUIRED]
    color: "&a" # Category's color for category & items. (OPTIONAL)
    slot: 1 # Category's slot. [REQUIRED]
    model: 12309 # Custom model data for 1.14+. (OPTIONAL)
    flags: # Item's flags (OPTIONAL)
      - HIDE_ENCHANTS # Will hide enchant names in lore.
    items: # Category's Item List [REQUIRED]
      - COBBLESTONE:12 # Item:Slot
```

### Group Configurating

```yaml
groups: # Groups for group menu.
  COBBLESTONE_PRODUCTS: # Item group name
    main_item: COBBLESTONE # Group's main bazaar item
    item_list: # Item list for group
      - COBBLESTONE:12 # Item:Slot
      - ENCHANTED_COBBLESTONE:16 # Item:Slot
```

### Item Name Detection Configuration

<pre class="language-yaml"><code class="lang-yaml"><strong>item_name_detection:
</strong>  model_data: true # If it's enabled, plugin will check for item model data to get bazaar item.
  name: # If it's enabled, plugin will check for item display name to get bazaar item.
    enabled: true
    type: "colored" # clean or colored
  durability: true # If it's enabled, plugin will check for item durability to get bazaar item.
  data: true # If it's enabled, plugin will check for item data to get bazaar item.
  type: true # If it's enabled, plugin will check for item type to get bazaar item.
  nbt: true # If it's enabled, plugin will check for BazaarITEM nbt to get bazaar item.
  same_item: false # If it's enabled, Minecraft item should be same with bazaar item.
  
  # Normal Items for default Minecraft item support.
  # Format Examples:
  # - ITEM_MATERIAL-ITEM_DATA: BAZAAR_ITEM_NAME
  # - ITEM_DISPLAYNAME-ITEM_DATA: BAZAAR_ITEM_NAME
  # - ITEM_NAME-ITEM_DATA: BAZAAR_ITEM_NAME
  normal_items:
    INK_SACK-0: INK
    INK_SACK-4: LAPIS_LAZULI
    INK_SACK-3: COCOA
    LOG-0: OAK_LOG
    LOG-1: SPRUCE_LOG
    LOG-2: BIRCH_LOG
    LOG-3: JUNGLE_LOG
    LOG_2-0: ACACIA_LOG
    LOG_2-1: DARK_OAK_LOG
    RAW_FISH-0: RAW_FISH
    RAW_FISH-1: SALMON
    RAW_FISH-2: CLOWNFISH
    RAW_FISH-3: PUFFERFISH
    NETHER_STALK-0: NETHER_WART
    NETHER_WARTS-0: NETHER_WART
    NETHER_WART-0: NETHER_WART
    SUGAR_CANE_BLOCK-0: SUGAR_CANE
    SUGAR_CANE-0: SUGAR_CANE
    CROPS-0: WHEAT

  # Custom Items for default Minecraft item support.
<strong>  custom_items:
</strong>    model_data: # ITEM_MODEL_DATA: BAZAAR_ITEM_NAME
       10: KING_SWORD
    durability: # ITEM_DURABILITY: BAZAAR_ITEM_NAME
      1000: KING_SWORD
</code></pre>


---

# 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://sedattr.gitbook.io/deluxebazaar/setup/items.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.
