💻guis.yml

The guis.yml file controls all GUI layouts, styling, and interactions in bShop. This centralized configuration allows you to customize the appearance and behavior of all shop interfaces.

Overview

The GUI configuration is divided into several main sections:

• Main Menu - Shop category selection

• Quantity Menu - Item quantity selection

• Recent Purchases Menu - Transaction history

• Bulk Stack Selection - Quick quantity options

Standard Actions

bShop provides predefined actions for GUI interactions:

Action	Description
wallet	Opens wallet info or does nothing
back_to_main	Returns to main menu
recent_purchases	Opens recent purchases GUI
recent_purchases_next	Next page in recent purchases
recent_purchases_prev	Previous page in recent purchases
shop:%shop%	Opens the specified shop

Standard Placeholders

Use these placeholders in display names and lore:

Placeholder	Description
%item%	Name of the item
%amount%	Amount bought/sold
%price%	Price of the transaction
%type%	Buy/Sell
%date%	Date of transaction
%shop%	Name of the shop
%transaction_id%	Unique transaction ID
%balance_after%	Player's balance after transaction

Main Menu Configuration

The main menu is the central hub for accessing different shop categories.

Basic Structure

main-menu:
  title: "Shop Categories"
  size: 3
  items:
    # Shop category items
  filler:
    enabled: true
    material: GRAY_STAINED_GLASS_PANE
    display-name: " "

Configuration Options

Property	Type	Required	Description
title	String	Yes	GUI window title
size	Integer	Yes	GUI size (1-6, representing 9-54 slots)
items	Map	Yes	Shop category items
filler	Object	No	Filler item configuration

Item Configuration

Each item in the main menu represents a shop category:

items:
  blocks:
    material: "PLAYER_HEAD"
    base64-head: "eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvYWM5NjRlZDBmNzE3YWU2NzFjZGYwZWQwZTAzNDE4ODdhZThjY2JkMjgyYzAwNThkYzExMjc2ZWYzY2Q3OGNjNyJ9fX0="
    slot: 10
    display-name: "<#66ff2e>⛏<bold> ʙᴜɪʟᴅɪɴɢ ʙʟᴏᴄᴋs</bold>"
    lore:
      - "<#BDBDBD><i>Browse a wide variety of"
      - "<#BDBDBD><i>blocks for your creations.</i>"
      - ""
      - "<#66ff2e>✔ Left-Click to browse."
    action: "shop:blocks"

Item Properties

Property	Type	Required	Description
material	String	Yes	Minecraft material name
slot	Integer	Yes	GUI slot position (0-53)
display-name	String	Yes	Item display name (supports MiniMessage)
lore	List	No	Item description lines
action	String	Yes	Action to perform when clicked
base64-head	String	No	Base64 encoded player head texture
texture	String	No	Player head texture URL

Special Items

Wallet Item

wallet:
  material: GOLD_INGOT
  slot: 4
  display-name: "<gold><bold>Wallet</bold>"
  lore:
    - "<gray>Balance: <yellow>%vault_eco_balance_formatted%"
    - "<gray>Click for more info!"
  action: "wallet"

Recent Purchases Item

recent_purchases:
  material: BOOK
  slot: 16
  display-name: "<#ffc31f>�� <bold>Recent Purchases</bold>"
  lore:
    - "<#BDBDBD>View your last 7 purchases and sales."
    - ""
    - "<#66ff2e>✔ Click to view."
  action: "recent_purchases"

Filler Configuration

Filler items fill empty slots in the GUI:

filler:
  enabled: true
  material: GRAY_STAINED_GLASS_PANE
  display-name: " "

Quantity Menu Configuration

The quantity menu allows players to select how many items to buy or sell.

Basic Structure

quantity-menu:
  title: "Select Quantity"
  size: 3
  display_item_slot: 13
  display_item:
    # Display item configuration
  filler:
    # Filler configuration
  buttons:
    # Quantity adjustment buttons
  stack_gui:
    # Bulk stack selection

Display Item Configuration

The display item shows what the player is buying/selling:

display_item:
  buy_display-name: "<#66ff2e><bold>ʙᴜʏɪɴɢ</bold> <#ffffff>%item%"
  sell_display-name: "<#e42121><bold>sᴇʟʟɪɴɢ</bold> <#ffffff>%item%"
  lore:
    - "<#BDBDBD>• Quantity: <#ffffff>%quantity%</#ffffff>"
    - "<#BDBDBD>• Price/Item: <#ffffff>%price_per_item%</#ffffff>"
    - ""
    - "<#BDBDBD>• Total Price: <#66ff2e>%total_price%</#66ff2e>"
    - ""
    - "<#ffc31f>ℹ <i>Use the buttons to"
    - "<#ffc31f><i>adjust the quantity.</i>"

Display Item Placeholders

Placeholder	Description
%item%	Item name
%quantity%	Selected quantity
%price_per_item%	Price per individual item
%total_price%	Total price for selected quantity

Button Configuration

Quantity adjustment buttons:

buttons:
  add_1:
    material: LIME_STAINED_GLASS_PANE
    display-name: "<#66ff2e><bold>+1</bold>"
    slot: 14
    action: "add_quantity:1"
  add_16:
    material: LIME_STAINED_GLASS_PANE
    display-name: "<#66ff2e><bold>+16</bold>"
    slot: 15
    action: "add_quantity:16"
  add_64:
    material: LIME_STAINED_GLASS_PANE
    display-name: "<#66ff2e><bold>+64</bold>"
    slot: 16
    action: "add_quantity:64"
  remove_1:
    material: RED_STAINED_GLASS_PANE
    display-name: "<#e42121><bold>-1</bold>"
    slot: 12
    action: "remove_quantity:1"
  remove_16:
    material: RED_STAINED_GLASS_PANE
    display-name: "<#e42121><bold>-16</bold>"
    slot: 11
    action: "remove_quantity:16"
  remove_64:
    material: RED_STAINED_GLASS_PANE
    display-name: "<#e42121><bold>-64</bold>"
    slot: 10
    action: "remove_quantity:64"

Action Buttons

Confirm Button

confirm:
  buy_material: GREEN_STAINED_GLASS_PANE
  sell_material: GREEN_STAINED_GLASS_PANE
  buy_display-name: "<#66ff2e><bold>✔ ᴄᴏɴꜰɪʀᴍ ᴘᴜʀᴄʜᴀsᴇ</bold>"
  sell_display-name: "<#66ff2e><bold>✔ ᴄᴏɴꜰɪʀᴍ sᴀʟᴇ</bold>"
  lore:
    - "<#BDBDBD><i>Click to complete the transaction.</i>"
  slot: 22
  action: "confirm_transaction"

Cancel Button

cancel:
  material: ARROW
  display-name: "<#e42121><bold>← ʙᴀᴄᴋ</bold>"
  lore:
    - "<#BDBDBD><i>Return to the previous menu.</i>"
  slot: 18
  action: "go_back"

Bulk Options Button

bulk_stacks:
  material: CHEST
  display-name: "<#2ecbff><bold>⭐ ʙᴜʟᴋ ᴏᴘᴛɪᴏɴs</bold>"
  lore:
    - "<#BDBDBD><i>Click for bulk stack options.</i>"
  slot: 26
  action: "open_stacks_menu"

Bulk Stack Selection GUI

The bulk stack selection provides quick quantity options.

Basic Structure

stack_gui:
  title: "Bulk Options"
  size: 3
  items:
    # Stack option items
  back_button:
    # Back button configuration
  filler:
    # Filler configuration

Stack Items

Each stack item represents a quantity option:

items:
  stack_1:
    material: CHEST
    display-name: "<#66ff2e>ʙᴜʏ <#B2FF96>1</#B2FF96> sᴛᴀᴄᴋ"
    sell_display-name: "<#e42121>sᴇʟʟ <#F19090>1</#F19090> sᴛᴀᴄᴋ"
    lore:
      - ""
      - "<#BDBDBD><i>Click to select this amount.</i>"
    slot: 9
    amount: 1
    action: "set_quantity_amount:64"

Stack Item Properties

Property	Type	Required	Description
material	String	Yes	Minecraft material name
display-name	String	Yes	Buy display name
sell_display-name	String	Yes	Sell display name
lore	List	No	Item description
slot	Integer	Yes	GUI slot position
amount	Integer	Yes	Number of stacks
action	String	Yes	Action with quantity parameter

Back Button

back_button:
  material: ARROW
  display-name: "<#e42121><bold>← ʙᴀᴄᴋ</bold>"
  lore: ["<#BDBDBD><i>Return to quantity selection.</i>"]
  slot: 22
  action: "open_quantity_menu"

Recent Purchases Menu

The recent purchases menu shows transaction history.

Basic Structure

recent-purchases-menu:
  title: "<gold>Recent Purchases"
  size: 3
  purchase_1:
    # Purchase item configuration
  # ... more purchase items
  previous_page:
    # Navigation buttons
  next_page:
  back:
  wallet:
  filler:

Purchase Items

Each purchase item shows a transaction:

purchase_1:
  slot: 10
  material: PAPER
  display-name: "<green>%type%: %item%"
  lore:
    - "<gray>Amount: <yellow>%amount%"
    - "<gray>Price: <gold>$%price%"
    - "<gray>Date: <white>%date%"
    - "<gray>Shop: <aqua>%shop%"
    - "<gray>ID: <white>%transaction_id%"
    - "<gray>Balance After: <green>$%balance_after%"

Navigation Buttons

Previous Page

previous_page:
  slot: 18
  material: RED_STAINED_GLASS_PANE
  display-name: "<red><bold>Previous Page"
  action: "recent_purchases_prev"

Next Page

next_page:
  slot: 26
  material: LIME_STAINED_GLASS_PANE
  display-name: "<green><bold>Next Page"
  action: "recent_purchases_next"

Back Button

back:
  slot: 22
  material: BARRIER
  display-name: "<red>Back"
  action: "back_to_main"

Wallet Button

wallet:
  slot: 4
  material: GOLD_INGOT
  display-name: "<gold><bold>Wallet</bold>"
  lore:
    - "<gray>Your balance: %vault_eco_balance_formatted%"
  action: "wallet"