🛒Standard Shops

Standard shops are the core shop type in bShop, providing a traditional buy/sell interface with customizable layouts, pagination, and item management.

Basic Configuration

Minimal Shop Setup

title: "My Shop"
size: 3

pagination:
  next_page:
    material: LIME_STAINED_GLASS_PANE
    display-name: "<green>Next Page"
    slot: 8
  previous_page:
    material: RED_STAINED_GLASS_PANE
    display-name: "<red>Previous Page"
    slot: 0
  back_to_menu:
    material: BARRIER
    display-name: "<red>Back to Menu"
    slot: 4
    action: "back_to_main_menu"
  filler:
    material: GRAY_STAINED_GLASS_PANE
    display-name: " "

items:
  - id: diamond
    material: DIAMOND
    display-name: "<blue>Diamond"
    buy-price: 100.0
    sell-price: 50.0

Shop Properties

Required Properties

Property	Type	Description	Example
title	String	Shop display name	"Blocks Shop"
size	Integer	GUI size (1-6, representing 9-54 slots)	3

Optional Properties

Property	Type	Description	Default
type	String	Shop type (null for standard)	null

Pagination Configuration

Pagination controls navigation and layout elements in your shop.

Navigation Items

pagination:
  next_page:
    material: LIME_STAINED_GLASS_PANE
    display-name: "<#66ff2e><bold>ɴᴇxᴛ ᴘᴀɢᴇ →</bold>"
    slot: 35
  previous_page:
    material: RED_STAINED_GLASS_PANE
    display-name: "<#e42121><bold>← ᴘʀᴇᴠɪᴏᴜs ᴘᴀɢᴇ</bold>"
    slot: 27
  back_to_menu:
    material: BARRIER
    display-name: "<#e42121><bold>ʙᴀᴄᴋ ᴛᴏ ᴍᴀɪɴ ᴍᴇɴᴜ</bold>"
    lore: ["<#BDBDBD><i>Return to shop categories.</i>"]
    slot: 31
    action: "back_to_main_menu"

Filler Items

pagination:
  filler:
    material: GRAY_STAINED_GLASS_PANE
    display-name: " "
    lore: []

Item Configuration

Basic Item Properties

items:
  - id: diamond
    material: DIAMOND
    display-name: "<bold><#2ecbff>Diamond</#2ecbff></bold>"
    lore:
      - "<#BDBDBD>Buy Price: <#66ff2e>%buy_price%"
      - "<#BDBDBD>Sell Price: <#e42121>%sell_price%"
      - ""
      - "<#66ff2e>✔ Left-Click to Buy"
      - "<#e42121>✔ Right-Click to Sell"
    buy-price: 150.0
    sell-price: 75.0

Item Properties Reference

Property	Type	Required	Description
id	String	Yes	Unique item identifier
material	String	Yes	Minecraft material name
display-name	String	Yes	Item display name (supports MiniMessage)
lore	List	No	Item description lines
buy-price	Double	No	Price to buy item (-1 to disable)
sell-price	Double	No	Price to sell item (-1 to disable)
slot	Integer	No	Fixed slot position
page	Integer	No	Fixed page number
custom-model-data	Integer	No	Custom model data for textures
base64-head	String	No	Base64 encoded player head texture
texture	String	No	Player head texture URL
currency-command	String	No	Custom currency command
currency-requirement	String	No	Currency balance check
buy-limit	Integer	No	Purchase limit per player
sell-limit	Integer	No	Sell limit per player

Advanced Item Features

Custom Model Data

- id: custom_sword
  material: DIAMOND_SWORD
  display-name: "<gold>Custom Sword"
  custom-model-data: 1001
  buy-price: 500.0

Player Heads

- id: custom_head
  material: PLAYER_HEAD
  base64-head: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYWM5NjRlZDBmNzE3YWU2NzFjZGYwZWQwZTAzNDE4ODdhZThjY2JkMjgyYzAwNThkYzExMjc2ZWYzY2Q3OGNjNyJ9fX0="
  display-name: "<green>Custom Head"
  buy-price: 100.0

Item Layout Options

Fixed Positioning

Items can be placed in specific slots and pages:

- id: diamond
  material: DIAMOND
  slot: 10      # Slot 10 on the page
  page: 0       # Page 0 (first page)
  display-name: "<blue>Diamond"
  buy-price: 150.0

Flow Layout

Items without fixed positions flow automatically:

- id: emerald
  material: EMERALD
  display-name: "<green>Emerald"
  buy-price: 100.0
  # No slot/page - will be placed automatically

Price Configuration

Buy/Sell Prices

# Both buy and sell enabled
buy-price: 100.0
sell-price: 50.0

# Buy only
buy-price: 100.0
sell-price: -1

# Sell only
buy-price: -1
sell-price: 50.0

# Neither (decorative item)
buy-price: -1
sell-price: -1

Price Placeholders

Use these placeholders in lore:

• %buy_price% - Formatted buy price

• %sell_price% - Formatted sell price

Common Patterns

Decorative Items

- id: info_sign
  material: OAK_SIGN
  display-name: "<yellow>Information"
  lore:
    - "<gray>This is a decorative item"
  buy-price: -1
  sell-price: -1
  action: "none"

Command-Based Items

- id: teleport_item
  material: COMPASS
  display-name: "<blue>Teleport Home"
  lore:
    - "<gray>Click to teleport home"
  buy-price: 0
  sell-price: -1
  buy-command: "home %player%"

Limited Items

- id: rare_item
  material: DIAMOND
  display-name: "<purple>Rare Item"
  buy-price: 500.0
  buy-limit: 1  # Only 1 per player

Troubleshooting

Common Issues

1. Items not appearing: Check slot/page numbers and shop size

2. Prices not showing: Ensure %buy_price% and %sell_price% are in lore

3. GUI errors: Verify pagination configuration

4. Permission issues: Check Vault integration

Debug Tips

• Use /shop reload to reload configurations

• Check server console for error messages

• Verify YAML syntax with online validators

• Test with simple configurations first