💬messasges.yml

Overview

bShop uses a centralized message system that supports:

• MiniMessage formatting for colors, gradients, and styling

• Placeholders for dynamic content insertion

• Consistent prefix across all messages

• Organized message categories for easy management

Message Formatting

MiniMessage Support

bShop supports the full MiniMessage specification for rich text formatting:

# Colors
prefix: "<gray>[<gradient:#F7971E:#FFD200>bShop</gradient>] </gray>"

# Examples of supported formatting:
# <red>Red text</red>
# <green>Green text</green>
# <gold>Gold text</gold>
# <aqua>Aqua text</aqua>
# <gray>Gray text</gray>
# <bold>Bold text</bold>
# <italic>Italic text</italic>
# <gradient:#F7971E:#FFD200>Gradient text</gradient>

Placeholders

All placeholders use the %placeholder% format:

Placeholder	Description	Example
%prefix%	Plugin prefix	[bShop]
%shop%	Shop name/ID	blocks
%item%	Item display name	Diamond Sword
%amount%	Transaction quantity	64
%price%	Transaction price	100.50
%balance%	Player's balance	250.00

Message Categories

1. General Messages

# Plugin prefix - used in all messages
prefix: "<gray>[<gradient:#F7971E:#FFD200>bShop</gradient>] </gray>"

# Permission and command messages
no_permission: "%prefix%<red>You do not have permission to do that.</red>"
player_only_command: "%prefix%<red>This command can only be executed by players.</red>"

2. Shop Transaction Messages

shop:
  # Shop not found
  not_found: "%prefix%<red>The shop '%shop%' could not be found.</red>"
  
  # Buy transaction messages
  buy_success: "%prefix%<green>You purchased <aqua>%amount%x %item%</aqua> for <gold>$%price%</gold>.</green>"
  buy_disabled: "%prefix%<red>This item cannot be purchased.</red>"
  insufficient_funds: "%prefix%<red>You need <gold>$%price%</gold> but only have <gold>$%balance%</gold>.</red>"
  inventory_full: "%prefix%<red>Your inventory is full!</red>"
  
  # Sell transaction messages
  sell_success: "%prefix%<green>You sold <aqua>%amount%x %item%</aqua> for <gold>$%price%</gold>.</green>"
  sell_disabled: "%prefix%<red>This item cannot be sold.</red>"
  item_not_owned: "%prefix%<red>You do not have <aqua>%amount%x %item%</aqua> to sell.</red>"
  
  # Custom currency messages
  insufficient_custom_currency: "<red>You do not have enough tokens to buy this item!</red>"
  
  # Purchase limit messages
  purchase_limit_reached: "%prefix%<red>You have reached the purchase limit for this item!</red>"
  sell_limit_reached: "%prefix%<red>You have reached the sell limit for this item!</red>"

3. GUI Error Messages

gui:
  # Missing GUI configurations
  main_menu_not_configured: "%prefix%<red>The main menu GUI is not configured in guis.yml.</red>"
  quantity_menu_not_configured: "%prefix%<red>The quantity menu GUI is not configured in guis.yml.</red>"
  stack_gui_not_configured: "%prefix%<red>The stack selection GUI is not configured in guis.yml.</red>"
  
  # GUI operation errors
  error_opening_quantity_gui: "%prefix%<red>Error opening quantity GUI: %error%</red>"

4. Admin Command Messages

admin:
  # Reload messages
  reload_start: "%prefix%<yellow>Reloading bShop configurations...</yellow>"
  reload_complete: "%prefix%<green>Reload complete.</green>"
  
  # Manual rotation messages
  rotate_usage: "<red>Usage: /shop rotate <shop>"
  rotate_not_rotational: "<red>The shop <gray>%shop%</gray> is not a rotational shop."
  rotate_success: "<green>Rotated the <gray>%shop%</gray> shop!"