Config shop.yml - BeestoXd/UltimateDonutSMP-V2 GitHub Wiki
shop.yml
The server shop, in two halves. SHOP-GUI and QUICK-BUY are the DonutSMP-style quick buy
flow, which fills orders straight from the Auction House rather than from an infinite admin
stock. SHARD-MENU is the separate premium shop bought with Shards.
Shard shop entries can do more than give an item: COMMAND runs a console command,
AMETHYST-TOOL together with AMETHYST-DURATION grants one of the timed tools from
amethyst-tools.yml, and the quantity keys control how many a player may buy in one go.
Sell prices are not set here โ they come from worth.yml.
A managed spawner is a SHARD-MENU entry whose COMMAND is
spawner give {player} <type> {amount}. The full list of shipped types and a paste-ready
block are in Adding spawners to the Shard Shop.
Comment at the top of the shipped file:
UltimateDonutSMP V2 Shop Configuration
/shop is modern DonutSMP Quick Buy with full Auction House integration.
On disk
plugins/UltimateDonutSmp2/shop.yml
Commands
/shop, /shardshop, /sell
Player-facing text
Edit CONFIG.SHOP in languages/<locale>.yml โ not this file
# Configuration section for Shop Web Analytics ServerSHOP-GUI:
SHOW-AUCTION-PRICE: true# Configuration section for Item.ITEM:
# Configuration section for Lore.LORE:
- '&7Shop price: {shop_price}'
- '{auction_line}'
- ''
- '{favorite_line}'
- '&eLeft-click to buy from the shop'
- '{auction_action}'
- '{favorite_action}'FAVORITES:
ENABLED: trueWEB-SERVER:
# Set to true to enable the embedded Shop Analytics web serverENABLED: false# Port for the embedded web server (e.g. 8080 or 25580)PORT: 8080# Optional custom domain or public URL (e.g. "https://stats.ultimatedonutsmp2mc.net" or "http://192.168.1.15:8080/stats")# If left empty (""), it automatically resolves to http://localhost:<PORT>/statsPUBLIC-URL: ""
Section: QUICK-BUY
Quick Buy configuration (/shop overhaul)
Options
Option path
Type
Accepted values
Default
What it does
QUICK-BUY.ENABLED
boolean
true, false
true
Master toggle for Quick Buy system
QUICK-BUY.ACTION-BAR
string
Any text
&fYou bought {amount} {item} for &a$ &f{price}
Action bar message displayed above the hotbar when purchasing an item Placeholders: {amount}, {item}, {price}, {price_formatted}
QUICK-BUY.PURCHASE-SOUND
string
Any text
minecraft:entity.experience_orb.pickup|1.0|1.0
Optional override for the purchase sound. Leave blank to use sounds.yml QUICK_BUY.BUY-SUCCESS.
QUICK-BUY.TITLE
string
Any text
&8Quick Buy
Main GUI title and inventory size
QUICK-BUY.SIZE
integer
Any integer
54
Chest size. Must be a multiple of 9 between 9 and 54.
QUICK-BUY.PRICING
Dynamic pricing settings for Quick Buy and market price estimation
Options
Option path
Type
Accepted values
Default
What it does
QUICK-BUY.PRICING.USE-AUCTION-HOUSE
boolean
true, false
true
Whether to follow the lowest active Auction House price when available
QUICK-BUY.PRICING.WORTH-MULTIPLIER
decimal
Any decimal number
1.0
Multiplier applied when using baseline price from worth.yml (default: 1.0)
QUICK-BUY.PRICING.AUTO-BALANCE-MISSING
boolean
true, false
true
Automatically calculate a fair balanced price for items missing from worth.yml
QUICK-BUY.PRICING.AUTO-BALANCE-MULTIPLIER
decimal
Any decimal number
1.0
Multiplier applied to automatically balanced prices (default: 1.0)
QUICK-BUY.PRICING.UNLISTED
string
WORTH, AUCTION-ONLY
WORTH
WORTH (default) still prices items that are not listed under FIXED-ITEMS from worth.yml. AUCTION-ONLY leaves those items out of stock until a matching auction listing exists.
QUICK-BUY.PRICING.FIXED-ITEMS
map
Bukkit material, or ENCHANTED_BOOK:<ENCHANT>:<LEVEL>, to a price per item
commented out
A material under FIXED-ITEMS sells at that price per item even when the auction house is empty. A cheaper auction listing still wins. A more expensive listing is ignored. Enchantment worth from worth.yml is added on top of a sword or tool. ENCHANTED_BOOK: 23332 covers every enchanted book at that price. A line such as ENCHANTED_BOOK:SHARPNESS:3 overrides just that book.
For how players pick enchants on those pins and how worth.yml surcharges stack on the base price,
see How to add enchants to fixed items
in the economy guide.
Mode for obtaining selectable items: VANILLA: all items/blocks/armor/swords directly from vanilla Minecraft matching the server version (default) CUSTOM: items configured in worth.yml
QUICK-BUY.CHOOSE-ITEM.MAX-ITEMS
integer
Any integer
2000
Maximum number of items to display in the selection list (default: 2000)
QUICK-BUY.CHOOSE-ITEM.BLACKLIST
list
A list of values
list of 30 items
Extra materials hidden from Quick Buy's Choose Item screen. Does not affect /orders. Wildcards such as *_SPAWN_EGG are allowed. Command-block variants, infested blocks, and spawn eggs are always hidden even if omitted here.
Default contents of QUICK-BUY.CHOOSE-ITEM.BLACKLIST (30 items)
Default contents of QUICK-BUY.EMPTY-SLOT.LORE (2 items)
LORE:
- '&o&7Click to choose'
- '&o&7an item to buy'
QUICK-BUY.ITEM
Item display and pricing lore formats for pinned quick buy items
Options
Option path
Type
Accepted values
Default
What it does
QUICK-BUY.ITEM.PRICE-FORMAT
string
Any text
&a$ &f{price}
Lore for the pinned item. {price} is the cost of the whole pin, unit price times the amount.
QUICK-BUY.ITEM.OUT-OF-STOCK
string
Any text
&cOut of stock
Out of stock.
QUICK-BUY.ITEM.EDIT-REMOVE-LORE
string
Any text
&o&7Click to remove
Edit remove lore.
QUICK-BUY.ITEM.EDIT-RESTORE-LORE
string
Any text
&o&7Click to add back
Edit restore lore.
QUICK-BUY.BUTTONS
Bottom navigation buttons in Quick Buy GUI
Entry schema (6 entries)
Each entry under QUICK-BUY.BUTTONS is keyed by a name you choose, and every entry accepts the same options:
Shipped entries
Entry key
NAME
MATERIAL
SLOT
FILTER
&fFilter
HOPPER
47
REFRESH
&fQuick Buy
ENDER_CHEST
48
AUCTION
&fAuction
ANVIL
49
SEARCH
&fSearch
OAK_SIGN
50
YOUR-ITEMS
&fYour Items
CHEST
51
EDIT
&fEdit
STICK
53
Key
Type
Accepted values
Required?
What it does
MATERIAL
string
Any text
Required
Bukkit Material name for the icon.
NAME
string
Any text
Required
Display name shown to players.
SLOT
integer
Any integer
Required
Inventory slot, 0 is the top-left cell.
LORE
string
Any text
Optional (5/6)
Tooltip lines under the item name.
ACTIVE-QUERY-LORE
list
A list of values
Optional (1/6)
The active query lore list.
LORE-EDITING
string
Any text
Optional (1/6)
Lore editing.
LORE-NORMAL
string
Any text
Optional (1/6)
Lore normal.
Default QUICK-BUY block as shipped
# Quick Buy configuration (/shop overhaul)QUICK-BUY:
# Master toggle for Quick Buy systemENABLED: true# Action bar message displayed above the hotbar when purchasing an item# Placeholders: {amount}, {item}, {price}, {price_formatted}ACTION-BAR: "&fYou bought {amount} {item} for &a$ &f{price}"# Optional override for the purchase sound. Leave blank to use sounds.yml QUICK_BUY.BUY-SUCCESS.PURCHASE-SOUND: "minecraft:entity.experience_orb.pickup|1.0|1.0"# Dynamic pricing settings for Quick Buy and market price estimationPRICING:
# Whether to follow the lowest active Auction House price when availableUSE-AUCTION-HOUSE: true# Multiplier applied when using baseline price from worth.yml (default: 1.0)WORTH-MULTIPLIER: 1.0# Automatically calculate a fair balanced price for items missing from worth.ymlAUTO-BALANCE-MISSING: true# Multiplier applied to automatically balanced prices (default: 1.0)AUTO-BALANCE-MULTIPLIER: 1.0# WORTH (default) still prices items that are not listed under FIXED-ITEMS from worth.yml.# AUCTION-ONLY leaves those items out of stock until a matching auction listing exists.# A material under FIXED-ITEMS sells at that price per item even when the auction house is empty.# A cheaper auction listing still wins. A more expensive listing is ignored.# Enchantment worth from worth.yml is added on top, so a sharpness sword costs more than the plain sword.# ENCHANTED_BOOK is the exception. That one price covers every enchant and level, including a book# with more than one enchant. Worth.yml is not added.# A line such as ENCHANTED_BOOK:SHARPNESS:3 overrides just that book.# Names are Bukkit materials. Quote a namespaced id, for example "minecraft:stick".UNLISTED: WORTH# FIXED-ITEMS:# STICK: 1.0# DIAMOND: 50.0# ENCHANTED_BOOK: 23332# ENCHANTED_BOOK:SHARPNESS:3: 5000# Main GUI title and inventory sizeTITLE: '&8Quick Buy'SIZE: 54# Item selection dialog configuration (Choose Item screen)CHOOSE-ITEM:
# Mode for obtaining selectable items:# VANILLA: all items/blocks/armor/swords directly from vanilla Minecraft matching the server version (default)# CUSTOM: items configured in worth.ymlMODE: VANILLA# Maximum number of items to display in the selection list (default: 2000)MAX-ITEMS: 2000# Extra materials hidden from Quick Buy's Choose Item screen. Does not affect /orders.# Wildcards such as *_SPAWN_EGG are allowed.# Command-block variants, infested blocks, and spawn eggs are always hidden even if omitted here.BLACKLIST:
- BEDROCK
- BARRIER
- COMMAND_BLOCK
- CHAIN_COMMAND_BLOCK
- REPEATING_COMMAND_BLOCK
- COMMAND_BLOCK_MINECART
- STRUCTURE_BLOCK
- STRUCTURE_VOID
- JIGSAW
- LIGHT# ... section continues, see the file on disk for the full block
Section: YOUR-ITEMS
Auction -> Your Items menu configuration Page 1 (free rank): 18 List slots + 27 Donut+ locks. Page 2: 45 Donut++ locks (all five content rows), Previous page on the left. Visual slots follow rank, not listing limit.
Options
Option path
Type
Accepted values
Default
What it does
YOUR-ITEMS.TITLE
string
Any text
Auction -> Your Items
Title text. Supports & colours and &#RRGGBB hex.
YOUR-ITEMS.SIZE
integer
Any integer
54
Chest size. Must be a multiple of 9 between 9 and 54.
YOUR-ITEMS.UNLOCKED-SLOTS
integer
Any integer
18
Unlocked slots.
YOUR-ITEMS.DONUT-PLUS-SLOTS
integer
Any integer
45
Donut plus slots.
YOUR-ITEMS.PLUS-PAGE-SLOTS
integer
Any integer
45
Plus page slots.
YOUR-ITEMS.SELL-BUTTON
Options
Option path
Type
Accepted values
Default
What it does
YOUR-ITEMS.SELL-BUTTON.SLOT
integer
Any integer
0
Inventory slot, 0 is the top-left cell.
YOUR-ITEMS.SELL-BUTTON.MATERIAL
string
Any text
GRAY_STAINED_GLASS_PANE
Bukkit Material name for the icon.
YOUR-ITEMS.SELL-BUTTON.NAME
string
Any text
&fList
Display name shown to players.
YOUR-ITEMS.SELL-BUTTON.LORE
list
A list of values
list of 1 item
Tooltip lines under the item name.
Default contents of YOUR-ITEMS.SELL-BUTTON.LORE (1 item)
LORE:
- '&o&7Click to sell an item'
YOUR-ITEMS.EMPTY-SLOT
Options
Option path
Type
Accepted values
Default
What it does
YOUR-ITEMS.EMPTY-SLOT.MATERIAL
string
Any text
GRAY_STAINED_GLASS_PANE
Bukkit Material name for the icon.
YOUR-ITEMS.EMPTY-SLOT.NAME
string
Any text
&fList
Display name shown to players.
YOUR-ITEMS.EMPTY-SLOT.LORE
list
A list of values
list of 1 item
Tooltip lines under the item name.
Default contents of YOUR-ITEMS.EMPTY-SLOT.LORE (1 item)
LORE:
- '&o&7Click to sell an item'
YOUR-ITEMS.LOCKED-SLOT
Options
Option path
Type
Accepted values
Default
What it does
YOUR-ITEMS.LOCKED-SLOT.MATERIAL
string
Any text
RED_STAINED_GLASS_PANE
Bukkit Material name for the icon.
YOUR-ITEMS.LOCKED-SLOT.NAME
string
Any text
&cLocked
Display name shown to players.
YOUR-ITEMS.LOCKED-SLOT.LORE
list
A list of values
list of 1 item
Tooltip lines under the item name.
Default contents of YOUR-ITEMS.LOCKED-SLOT.LORE (1 item)
LORE:
- '&fBuy Donut&b+&f for more auction slots'
YOUR-ITEMS.LOCKED-PLUS-SLOT
Options
Option path
Type
Accepted values
Default
What it does
YOUR-ITEMS.LOCKED-PLUS-SLOT.MATERIAL
string
Any text
RED_STAINED_GLASS_PANE
Bukkit Material name for the icon.
YOUR-ITEMS.LOCKED-PLUS-SLOT.NAME
string
Any text
&cLocked
Display name shown to players.
YOUR-ITEMS.LOCKED-PLUS-SLOT.LORE
list
A list of values
list of 1 item
Tooltip lines under the item name.
Default contents of YOUR-ITEMS.LOCKED-PLUS-SLOT.LORE (1 item)
LORE:
- '&fBuy Donut&b++&f for even more auction slots'
YOUR-ITEMS.ACTIVE-ITEM
Options
Option path
Type
Accepted values
Default
What it does
YOUR-ITEMS.ACTIVE-ITEM.PRICE-FORMAT
string
Any text
&7Price: &a${price}
Price format.
YOUR-ITEMS.ACTIVE-ITEM.EXPIRES-FORMAT
string
Any text
&7Expires in: &e{time}
Expires format.
YOUR-ITEMS.ACTIVE-ITEM.CANCEL-LORE
string
Any text
&cClick to cancel listing
Cancel lore.
YOUR-ITEMS.BUTTONS
Entry schema (7 entries)
Each entry under YOUR-ITEMS.BUTTONS is keyed by a name you choose, and every entry accepts the same options:
Shipped entries
Entry key
NAME
MATERIAL
SLOT
PREV
&fPrevious page
ARROW
45
FILTER
&fFilter
HOPPER
47
QUICK-BUY
&fQuick Buy
ENDER_CHEST
48
AUCTION
&fAuction
ANVIL
49
SEARCH
&fSearch
OAK_SIGN
50
TRANSACTIONS
&fTransactions
WRITABLE_BOOK
51
NEXT
&fNext page
ARROW
53
Key
Type
Accepted values
Required?
What it does
LORE
list
A list of values
Required
Tooltip lines under the item name.
MATERIAL
string
Any text
Required
Bukkit Material name for the icon.
NAME
string
Any text
Required
Display name shown to players.
SLOT
integer
Any integer
Required
Inventory slot, 0 is the top-left cell.
ACTIVE-QUERY-LORE
list
A list of values
Optional (1/7)
The active query lore list.
Default YOUR-ITEMS block as shipped
# Auction -> Your Items menu configuration# Page 1 (free rank): 18 List slots + 27 Donut+ locks. Page 2: 45 Donut++ locks# (all five content rows), Previous page on the left. Visual slots follow rank, not listing limit.YOUR-ITEMS:
TITLE: 'Auction -> Your Items'SIZE: 54UNLOCKED-SLOTS: 18DONUT-PLUS-SLOTS: 45PLUS-PAGE-SLOTS: 45SELL-BUTTON:
SLOT: 0MATERIAL: GRAY_STAINED_GLASS_PANENAME: '&fList'LORE:
- '&o&7Click to sell an item'EMPTY-SLOT:
MATERIAL: GRAY_STAINED_GLASS_PANENAME: '&fList'LORE:
- '&o&7Click to sell an item'LOCKED-SLOT:
MATERIAL: RED_STAINED_GLASS_PANENAME: '&cLocked'LORE:
- '&fBuy Donut&b+&f for more auction slots'LOCKED-PLUS-SLOT:
MATERIAL: RED_STAINED_GLASS_PANENAME: '&cLocked'LORE:
- '&fBuy Donut&b++&f for even more auction slots'ACTIVE-ITEM:
PRICE-FORMAT: '&7Price: &a${price}'EXPIRES-FORMAT: '&7Expires in: &e{time}'CANCEL-LORE: '&cClick to cancel listing'BUTTONS:
PREV:
SLOT: 45MATERIAL: ARROWNAME: '&fPrevious page'LORE:
- '&o&7Click to view previous page'FILTER:
SLOT: 47MATERIAL: HOPPERNAME: '&fFilter'LORE:
- '&o&7Click to change'QUICK-BUY:
# ... section continues, see the file on disk for the full block
Section: INSERT-ITEM
Click to sell an item (5-slot hopper menu) configuration
Options
Option path
Type
Accepted values
Default
What it does
INSERT-ITEM.TITLE
string
Any text
Click to sell an item
Title text. Supports & colours and &#RRGGBB hex.
INSERT-ITEM.ESTIMATED-PRICE-FORMAT
string
Any text
&a$ &f{price}
Estimated price format.
INSERT-ITEM.CANCEL-BUTTON
Options
Option path
Type
Accepted values
Default
What it does
INSERT-ITEM.CANCEL-BUTTON.SLOT
integer
Any integer
0
Inventory slot, 0 is the top-left cell.
INSERT-ITEM.CANCEL-BUTTON.MATERIAL
string
Any text
RED_STAINED_GLASS_PANE
Bukkit Material name for the icon.
INSERT-ITEM.CANCEL-BUTTON.NAME
string
Any text
&cCancel
Display name shown to players.
INSERT-ITEM.CANCEL-BUTTON.LORE
list
A list of values
list of 1 item
Tooltip lines under the item name.
Default contents of INSERT-ITEM.CANCEL-BUTTON.LORE (1 item)
LORE:
- '&7Click to cancel and return'
INSERT-ITEM.CONFIRM-BUTTON
Options
Option path
Type
Accepted values
Default
What it does
INSERT-ITEM.CONFIRM-BUTTON.SLOT
integer
Any integer
4
Inventory slot, 0 is the top-left cell.
INSERT-ITEM.CONFIRM-BUTTON.MATERIAL
string
Any text
LIME_STAINED_GLASS_PANE
Bukkit Material name for the icon.
INSERT-ITEM.CONFIRM-BUTTON.NAME
string
Any text
&fConfirm
Display name shown to players.
INSERT-ITEM.CONFIRM-BUTTON.LORE
list
A list of values
list of 1 item
Tooltip lines under the item name.
Default contents of INSERT-ITEM.CONFIRM-BUTTON.LORE (1 item)
LORE:
- '&o&7Click to confirm'
Default INSERT-ITEM block as shipped
# Click to sell an item (5-slot hopper menu) configurationINSERT-ITEM:
TITLE: 'Click to sell an item'CANCEL-BUTTON:
SLOT: 0MATERIAL: RED_STAINED_GLASS_PANENAME: '&cCancel'LORE:
- '&7Click to cancel and return'CONFIRM-BUTTON:
SLOT: 4MATERIAL: LIME_STAINED_GLASS_PANENAME: '&fConfirm'LORE:
- '&o&7Click to confirm'ESTIMATED-PRICE-FORMAT: '&a$ &f{price}'