BharatCore: Web Store, Announcements & Sound System

Detailed line-by-line configuration and option reference for BharatCore: Web Store, Announcements & Sound System.

---

📄 store.yml

Web store automated command dispatch, offline delivery queuing, and order logging.

Full YAML Source (store.yml)

# ==============================================================================
# BharatMC Core - Store Module Configuration
# ==============================================================================
# Manages webstore sync, Redis real-time command execution, BMC coin wallet,
# and package/donation broadcasts.
# ==============================================================================

store:
  enabled: true
  url: "https://store.bharatmc.net"
  submodules:
    # Real-time command execution via Redis
    execution: true
    # BMC Coin wallet & balance commands (/bmc bal, /bmc pay)
    wallet: true
    # Safe kit delivery
    kits: true
    # In-game donation event announcements
    donations: true

  api:
    url: "https://api.bharatmc.net"
    key: "KbTC1cfjm6OvSRtRGTzqPVQtttNLroRm4TaDPOpO"
    timeout-seconds: 10

prefix: "<gradient:#FF9100:#FFBA00><bold>BHARATMC</bold></gradient> <dark_gray>➥</dark_gray> "

messages:
  separator: "<dark_gray>----------------------------------------</dark_gray>"
  info:
    - ""
    - "<#ffaa00><bold>🛒 Visit Our Store</bold></#ffaa00>"
    - ""
    - "<white>Purchase <#ffd580>ranks</#ffd580>, coins, keys, and crate bundles."
    - "<white>Support the server and unlock <#ffd580>premium rewards</#ffd580>."
    - ""
    - "<click:open_url:\"https://store.bharatmc.net\"><hover:show_text:\"<gray>Click to visit our store!\"><#ffaa00>♦ <white>store.bharatmc.net</hover></click>"
    - ""

  purchase:
    success:
      - "<green><bold>✅ PURCHASE SUCCESSFUL!</bold></green>"
      - "<gray>Thank you for your purchase, <yellow>%player%</yellow>!<gray>"
      - "<gray>Package: <aqua>%bmc_package%</aqua></gray>"
      - "<gray>Amount: <green>₹%amount%</green></gray>"
      - "<gray>Server: <light_purple>%server%</light_purple></gray>"
      - "<gray>Time: <white>%time%</white></gray>"
      - "<gray>Your items have been delivered. Enjoy your purchase!</gray>"

    processing:
      - "<yellow><bold>⏳ PROCESSING PURCHASE...</bold></yellow>"
      - "<gray>Your purchase is being processed.</gray>"
      - "<gray>Package: <aqua>%bmc_package%</aqua></gray>"
      - "<gray>Please wait a moment...</gray>"

    failed:
      - "<red><bold>❌ PURCHASE FAILED!</bold></red>"
      - "<gray>Sorry, your purchase could not be completed.</gray>"
      - "<gray>Reason: <red>%bmc_reason%</red></gray>"
      - "<gray>Please try again or contact support.</gray>"

    inventory_full:
      - "<red><bold>⚠️ INVENTORY FULL!</bold></red>"
      - "<gray>We couldn't deliver your items because your inventory is full.</gray>"
      - "<gray>Please clear some space! We will retry automatically when space is available.</gray>"

  broadcast:
    donor_announcement:
      - "<gold><bold>🎉 NEW DONATION!</bold></gold>"
      - "<gray><yellow>%donor_name%</yellow> just purchased <aqua>%package%</aqua>!<gray>"
      - "<gray>Amount: <green>%amount% %currency%</green></gray>"
      - "<gray>Thank you for supporting BharatMC!</gray>"

Key Options & Behavior Breakdown

Option / Key Path	Default Setting	Technical Functionality & Usage
store	Object	Root configuration section managing store subsystem.
store.enabled	true	Adjusts enabled parameter for the store handler.
store.url	"https://store.bharatmc.net"	Adjusts url parameter for the store handler.
store.submodules	List/Object	Adjusts submodules parameter for the store handler.
store.api	List/Object	Adjusts api parameter for the store handler.
prefix	"<gradient:#FF9100:#FFBA00><bold>BHARATMC</bold></gradient> <dark_gray>➥</dark_gray> "	Root configuration section managing prefix subsystem.
messages	Object	Root configuration section managing messages subsystem.
messages.separator	"<dark_gray>----------------------------------------</dark_gray>"	Adjusts separator parameter for the messages handler.
messages.info	List/Object	Adjusts info parameter for the messages handler.
messages.purchase	List/Object	Adjusts purchase parameter for the messages handler.
messages.broadcast	List/Object	Adjusts broadcast parameter for the messages handler.

---

📄 store_messages.yml

Network-wide celebration titles, action-bar banners, and sound alerts for webstore checkouts.

Full YAML Source (store_messages.yml)

# ================================================
# BharatMC Store & Sync - Messages Configuration
# ================================================
# Supports MiniMessage (<#rrggbb>, <bold>, etc.) and Legacy/Hex (&a, &#rrggbb)
#

prefix: "<gradient:#FF9100:#FFBA00><bold>BHARATMC</bold></gradient> <dark_gray>➥</dark_gray> "

store:
  separator: "<dark_gray>----------------------------------------</dark_gray>"
  url: "https://store.bharatmc.net"
  info:
    - ""
    - "<#ffaa00><bold>🛒 Visit Our Store</bold></#ffaa00>"
    - ""
    - "<white>Purchase <#ffd580>ranks</#ffd580>, coins, keys, and crate bundles."
    - "<white>Support the server and unlock <#ffd580>premium rewards</#ffd580>."
    - ""
    - "<click:open_url:\"https://store.bharatmc.net\"><hover:show_text:\"<gray>Click to visit our store!\"><#ffaa00>♦ <white>store.bharatmc.net</hover></click>"
    - ""

# ================================================
# PURCHASE & DELIVERY MESSAGES
# ================================================
purchase:
  success:
    - "<green><bold>✅ PURCHASE SUCCESSFUL!</bold></green>"
    - "<gray>Thank you for your purchase, <yellow>%player%</yellow>!<gray>"
    - "<gray>Package: <aqua>%bmc_package%</aqua></gray>"
    - "<gray>Amount: <green>₹%amount%</green></gray>"
    - "<gray>Server: <light_purple>%server%</light_purple></gray>"
    - "<gray>Time: <white>%time%</white></gray>"
    - "<gray>Your items have been delivered. Enjoy your purchase!</gray>"

  processing:
    - "<yellow><bold>⏳ PROCESSING PURCHASE...</bold></yellow>"
    - "<gray>Your purchase is being processed.</gray>"
    - "<gray>Package: <aqua>%bmc_package%</aqua></gray>"
    - "<gray>Please wait a moment...</gray>"

  failed:
    - "<red><bold>❌ PURCHASE FAILED!</bold></red>"
    - "<gray>Sorry, your purchase could not be completed.</gray>"
    - "<gray>Reason: <red>%bmc_reason%</red></gray>"
    - "<gray>Please try again or contact support.</gray>"

  inventory_full:
    - "<red><bold>⚠️ INVENTORY FULL!</bold></red>"
    - "<gray>We couldn't deliver your items because your inventory is full.</gray>"
    - "<gray>Please clear some space! We will retry automatically when space is available.</gray>"

# ================================================
# BROADCAST & DONATIONS
# ================================================
broadcast:
  donor_announcement:
    - "<gold><bold>🎉 NEW DONATION!</bold></gold>"
    - "<gray><yellow>%donor_name%</yellow> just purchased <aqua>%package%</aqua>!<gray>"
    - "<gray>Amount: <green>%amount% %currency%</green></gray>"
    - "<gray>Thank you for supporting BharatMC!</gray>"
    - "<gray><italic>Visit our store: <aqua>https://store.bharatmc.net</aqua></italic></gray>"

# ================================================
# BMC COIN & WALLET MESSAGES (/bmc, /coins, /wallet)
# ================================================
bmc:
  no_permission: "<red>You don't have permission to use this command!</red>"
  player_only: "<red>This command can only be used by players!</red>"
  invalid_amount: "<red>Invalid amount! Please enter a valid number.</red>"
  amount_positive: "<red>Amount must be positive!</red>"

  balance:
    checking: "<yellow>Fetching your BMC coin balance...</yellow>"
    display:
      - "<gold><bold>=== Your BMC Coin Balance ===</bold></gold>"
      - "<yellow>Balance: <green><bold>%bmc_balance%</bold> BMC Coins</green></yellow>"
    error: "<red>Failed to fetch coin balance: %bmc_error%</red>"

  pay:
    usage: "<red>Usage: /bmc pay <player> <amount></red>"
    cannot_pay_self: "<red>You cannot pay yourself!</red>"
    insufficient_funds: "<red>You do not have enough BMC coins! Balance: %bmc_balance%</red>"
    target_not_found: "<red>Target player '%bmc_player%' not found or not registered!</red>"
    processing: "<yellow>Processing payment of %bmc_amount% BMC coins to %bmc_player%...</yellow>"
    success:
      - "<gold><bold>✅ PAYMENT SENT!</bold></gold>"
      - "<green>You sent <yellow>%bmc_amount% BMC coins</yellow> to <yellow>%bmc_player%</yellow></green>"
      - "<gray>New balance: <green>%bmc_balance% coins</green></gray>"
    received:
      - "<gold><bold>💰 PAYMENT RECEIVED!</bold></gold>"
      - "<green>You received <yellow>%bmc_amount% BMC coins</yellow> from <yellow>%bmc_player%</yellow></green>"
      - "<gray>New balance: <green>%bmc_balance% coins</green></gray>"
    failed: "<red>Payment failed! Please try again later.</red>"

  give:
    usage: "<red>Usage: /bmc give <player> <amount></red>"
    processing: "<yellow>Giving %bmc_amount% BMC coins to %bmc_player%...</yellow>"
    success: "<green>Successfully gave <yellow>%bmc_amount% BMC coins</yellow> to <yellow>%bmc_player%</yellow>!</green>"
    failed: "<red>Failed to give coins! Player may not be registered.</red>"

  take:
    usage: "<red>Usage: /bmc take <player> <amount></red>"
    processing: "<yellow>Taking %bmc_amount% BMC coins from %bmc_player%...</yellow>"
    success: "<green>Successfully took <yellow>%bmc_amount% BMC coins</yellow> from <yellow>%bmc_player%</yellow>!</green>"
    failed: "<red>Failed to take coins! Player may not have enough balance.</red>"

  set:
    usage: "<red>Usage: /bmc set <player> <amount></red>"
    processing: "<yellow>Setting %bmc_player%'s balance to %bmc_amount%...</yellow>"
    success: "<green>Successfully set <yellow>%bmc_player%</yellow>'s balance to <yellow>%bmc_amount% BMC coins</yellow>!</green>"
    failed: "<red>Failed to set coins! Player may not be registered.</red>"

  check:
    usage: "<red>Usage: /bmc check <player></red>"
    processing: "<yellow>Checking %bmc_player%'s balance...</yellow>"
    success:
      - "<gold><bold>=== Player Balance Check ===</bold></gold>"
      - "<yellow>Player: <white>%bmc_player%</white></yellow>"
      - "<yellow>Balance: <green>%bmc_balance% BMC Coins</green></yellow>"
    player_not_found: "<red>Player '%bmc_player%' not found or not registered!</red>"

  help:
    - "<gold><bold>=== BharatMC Store Commands ===</bold></gold>"
    - "<yellow>/bmc bal <gray>- Check your BMC coin balance</gray></yellow>"
    - "<yellow>/bmc pay <player> <amount> <gray>- Pay coins to another player</gray></yellow>"
    - "<yellow>/store <gray>- Open webstore link</gray></yellow>"
    - "<yellow>/vote <gray>- Access voting sites and rewards</gray></yellow>"
    - "<red><bold>=== Admin Commands ===</bold></red>"
    - "<yellow>/bmc give <player> <amount> <gray>- Give coins to player</gray></yellow>"
    - "<yellow>/bmc take <player> <amount> <gray>- Take coins from player</gray></yellow>"
    - "<yellow>/bmc set <player> <amount> <gray>- Set player coins</gray></yellow>"
    - "<yellow>/bmc check <player> <gray>- Check another player's balance</gray></yellow>"

# ================================================
# VOTING & VOTE PARTY MESSAGES
# ================================================
vote:
  link:
    - ""
    - "<#0EFF4F><bold>BHARATMC VOTE REWARDS</bold></#0EFF4F>"
    - ""
    - "<#0EFF4F>⬇ <bold>VOTE TODAY</bold> ⬇</#0EFF4F>"
    - "<click:open_url:\"https://bharatmc.net/vote\"><#FFF914><u>https://bharatmc.net/vote</u></click>"
    - ""

  rewards:
    success:
      - "<green><bold>✅ VOTE REWARDS DELIVERED!</bold></green>"
      - "<gray>Thank you for voting on <yellow>%site%</yellow>!</gray>"
      - "<gray>Your rewards have been delivered successfully.</gray>"
      - "<gray>Vote daily to earn more keys, coins, and perks!</gray>"
    title: "<aqua><bold>VOTE REWARDS</bold></aqua>"
    subtitle: "<green>Thank you for voting on {site}!</green>"
    broadcast: "<gold><bold>[VOTE]</bold></gold> <yellow>{player}</yellow> <gray>claimed their vote reward! Vote daily via <gold>/vote</gold>!</gray>"

  voteparty:
    reached:
      broadcast:
        - ""
        - "<gold><bold>🎉 VOTE PARTY GOAL REACHED! 🎉</bold></gold>"
        - "<yellow>The community reached <aqua><bold>%voteparty_target%</bold></aqua> votes!</yellow>"
        - "<gray>Rewards are being distributed to all online players!</gray>"
        - "<gray>Use <green>/vote</green> to contribute to the next party!</gray>"
        - ""
      title: "<gold><bold>VOTE PARTY!</bold></gold>"
      subtitle: "<green>Goal Reached! Rewards Distributed 🎁</green>"
      actionbar: "<yellow><bold>🎉 VOTE PARTY GOAL REACHED!</bold> Check your inventory for rewards!</yellow>"

    reminder:
      - "<gold><bold>🎈 VOTE PARTY PROGRESS</bold></gold>"
      - "<gray>Current Votes: <yellow>%voteparty_votes%</yellow>/<aqua>%voteparty_target%</aqua></gray>"
      - "<gray>Votes Needed: <green>%voteparty_needed%</green></gray>"
      - "<gray>Vote now at <aqua>https://bharatmc.net/vote</aqua> to help!</gray>"

Key Options & Behavior Breakdown

Option / Key Path	Default Setting	Technical Functionality & Usage
prefix	"<gradient:#FF9100:#FFBA00><bold>BHARATMC</bold></gradient> <dark_gray>➥</dark_gray> "	Root configuration section managing prefix subsystem.
store	Object	Root configuration section managing store subsystem.
store.separator	"<dark_gray>----------------------------------------</dark_gray>"	Adjusts separator parameter for the store handler.
store.url	"https://store.bharatmc.net"	Adjusts url parameter for the store handler.
store.info	List/Object	Adjusts info parameter for the store handler.
purchase	Object	Root configuration section managing purchase subsystem.
purchase.success	List/Object	Adjusts success parameter for the purchase handler.
purchase.processing	List/Object	Adjusts processing parameter for the purchase handler.
purchase.failed	List/Object	Adjusts failed parameter for the purchase handler.
purchase.inventory_full	List/Object	Adjusts inventory_full parameter for the purchase handler.
broadcast	Object	Root configuration section managing broadcast subsystem.
broadcast.donor_announcement	List/Object	Adjusts donor_announcement parameter for the broadcast handler.
bmc	Object	Root configuration section managing bmc subsystem.
bmc.no_permission	"<red>You don't have permission to use this command!</red>"	Adjusts no_permission parameter for the bmc handler.
bmc.player_only	"<red>This command can only be used by players!</red>"	Adjusts player_only parameter for the bmc handler.
bmc.invalid_amount	"<red>Invalid amount! Please enter a valid number.</red>"	Adjusts invalid_amount parameter for the bmc handler.
bmc.amount_positive	"<red>Amount must be positive!</red>"	Adjusts amount_positive parameter for the bmc handler.
bmc.balance	List/Object	Adjusts balance parameter for the bmc handler.
bmc.pay	List/Object	Adjusts pay parameter for the bmc handler.
bmc.give	List/Object	Adjusts give parameter for the bmc handler.
bmc.take	List/Object	Adjusts take parameter for the bmc handler.
bmc.set	List/Object	Adjusts set parameter for the bmc handler.
bmc.check	List/Object	Adjusts check parameter for the bmc handler.
bmc.help	List/Object	Adjusts help parameter for the bmc handler.
vote	Object	Root configuration section managing vote subsystem.
vote.link	List/Object	Adjusts link parameter for the vote handler.
vote.rewards	List/Object	Adjusts rewards parameter for the vote handler.
vote.voteparty	List/Object	Adjusts voteparty parameter for the vote handler.

---

📄 sounds.yml

Centralized sound effect registry controlling UI clicks, errors, combat tags, and victory alerts.

Full YAML Source (sounds.yml)

# ==============================================================================
#                  BharatCore Unified Sounds Configuration
# ==============================================================================
# Master control to toggle ALL sounds in BharatCore at once:
#   enabled: true / false
#
# Sound Structure for each trigger:
#   enabled: true / false     - Whether this specific sound will trigger
#   sound: "SOUND_NAME"       - Bukkit Sound Enum or Minecraft 1.21 Resource Key
#   volume: 1.0               - Float between 0.0 and 2.0 (Sound loudness/distance)
#   pitch: 1.0                - Float between 0.5 and 2.0 (Pitch/Frequency of sound)
#
# 🔗 Complete Reference for all 1.21 Sound Names:
#    Official Paper/Bukkit Sound Javadocs:
#    https://jd.papermc.io/paper/1.21/org/bukkit/Sound.html
#
#    Official Minecraft Wiki Sound List:
#    https://minecraft.wiki/w/Sounds.json
# ==============================================================================

# Global Master Toggle: Set to false to disable ALL sounds dispatched by BharatCore
enabled: true

# ------------------------------------------------------------------------------
# 💬 Chat & Social Sounds
# ------------------------------------------------------------------------------
chat:
  # Trigger: When a player is tagged in chat with @Player
  mention:
    enabled: true
    sound: "BLOCK_NOTE_BLOCK_PLING"
    volume: 1.0
    pitch: 1.5

  # Trigger: When a player receives a private message (/msg, /tell, /r)
  direct-message-received:
    enabled: true
    sound: "BLOCK_NOTE_BLOCK_CHIME"
    volume: 1.0
    pitch: 1.2

  # Trigger: When a player sends a private message
  direct-message-sent:
    enabled: true
    sound: "UI_BUTTON_CLICK"
    volume: 0.8
    pitch: 1.0

# ------------------------------------------------------------------------------
# 🖥️ GUI & Menu Interactions
# ------------------------------------------------------------------------------
gui:
  # Trigger: Standard button click in any BharatCore GUI menu
  click:
    enabled: true
    sound: "UI_BUTTON_CLICK"
    volume: 1.0
    pitch: 1.0

  # Trigger: Successfully purchasing, unlocking, or equipping a cosmetic / item
  success:
    enabled: true
    sound: "ENTITY_PLAYER_LEVELUP"
    volume: 1.0
    pitch: 2.0

  # Trigger: Action denied, insufficient funds, or locked item clicked
  denied:
    enabled: true
    sound: "ENTITY_VILLAGER_NO"
    volume: 1.0
    pitch: 1.0

  # Trigger: Flipping between menu pages or opening submenus
  page-change:
    enabled: true
    sound: "ITEM_BOOK_PAGE_TURN"
    volume: 0.9
    pitch: 1.0

  # Trigger: Closing a menu or returning to previous screen
  close:
    enabled: true
    sound: "ENTITY_ENDERMAN_TELEPORT"
    volume: 0.7
    pitch: 1.2

# ------------------------------------------------------------------------------
# 🚀 Teleportation & Movement
# ------------------------------------------------------------------------------
teleportation:
  # Trigger: Successfully arriving at Home, Warp, Spawn, or TPA location
  success:
    enabled: true
    sound: "ENTITY_ENDERMAN_TELEPORT"
    volume: 1.0
    pitch: 1.0

  # Trigger: Teleport warmup countdown tick (per-second sound)
  warmup-tick:
    enabled: true
    sound: "UI_BUTTON_CLICK"
    volume: 0.6
    pitch: 1.3

  # Trigger: Teleport cancelled due to movement or damage
  warmup-cancelled:
    enabled: true
    sound: "ENTITY_VILLAGER_NO"
    volume: 1.0
    pitch: 0.8

  # Trigger: Falling into void in safe world and recovered to spawn
  void-recovery:
    enabled: true
    sound: "ENTITY_ENDERMAN_TELEPORT"
    volume: 1.0
    pitch: 1.0

  # Trigger: Player throws an Ender Pearl

# ... [Subsequent repetitive milestone/item tiers follow identical YAML structure] ...

perks:
  # Trigger: Executing /repair or /repair all
  repair:
    enabled: true
    sound: "BLOCK_ANVIL_USE"
    volume: 1.0
    pitch: 1.0

  # Trigger: Executing /heal or /feed
  heal:
    enabled: true
    sound: "ENTITY_PLAYER_LEVELUP"
    volume: 0.8
    pitch: 1.8

  # Trigger: Toggling /nv (Night Vision)
  night-vision:
    enabled: true
    sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
    volume: 1.0
    pitch: 1.0

  # Trigger: Running /ping
  ping:
    enabled: true
    sound: "ENTITY_PLAYER_LEVELUP"
    volume: 0.6
    pitch: 1.5

  # Trigger: Opening virtual utility menus (/trash, /craft, /ec, etc.)
  virtual-inventory:
    enabled: true
    sound: "BLOCK_CHEST_OPEN"
    volume: 0.8
    pitch: 1.0

Key Options & Behavior Breakdown

Option / Key Path	Default Setting	Technical Functionality & Usage
enabled	true	Root configuration section managing enabled subsystem.
chat	Object	Root configuration section managing chat subsystem.
chat.mention	List/Object	Adjusts mention parameter for the chat handler.
chat.direct-message-received	List/Object	Adjusts direct-message-received parameter for the chat handler.
chat.direct-message-sent	List/Object	Adjusts direct-message-sent parameter for the chat handler.
gui	Object	Root configuration section managing gui subsystem.
gui.click	List/Object	Adjusts click parameter for the gui handler.
gui.success	List/Object	Adjusts success parameter for the gui handler.
gui.denied	List/Object	Adjusts denied parameter for the gui handler.
gui.page-change	List/Object	Adjusts page-change parameter for the gui handler.
gui.close	List/Object	Adjusts close parameter for the gui handler.
teleportation	Object	Root configuration section managing teleportation subsystem.
teleportation.success	List/Object	Adjusts success parameter for the teleportation handler.
teleportation.warmup-tick	List/Object	Adjusts warmup-tick parameter for the teleportation handler.
teleportation.warmup-cancelled	List/Object	Adjusts warmup-cancelled parameter for the teleportation handler.
teleportation.void-recovery	List/Object	Adjusts void-recovery parameter for the teleportation handler.
teleportation.enderpearl-throw	List/Object	Adjusts enderpearl-throw parameter for the teleportation handler.
teleportation.enderpearl-land	List/Object	Adjusts enderpearl-land parameter for the teleportation handler.
moderation	Object	Root configuration section managing moderation subsystem.
moderation.staff-alert	List/Object	Adjusts staff-alert parameter for the moderation handler.
moderation.report-submitted	List/Object	Adjusts report-submitted parameter for the moderation handler.
moderation.player-frozen	List/Object	Adjusts player-frozen parameter for the moderation handler.
moderation.player-jailed	List/Object	Adjusts player-jailed parameter for the moderation handler.
moderation.direct-alert	List/Object	Adjusts direct-alert parameter for the moderation handler.
moderation.broadcast	List/Object	Adjusts broadcast parameter for the moderation handler.
perks	Object	Root configuration section managing perks subsystem.
perks.repair	List/Object	Adjusts repair parameter for the perks handler.
perks.heal	List/Object	Adjusts heal parameter for the perks handler.
perks.night-vision	List/Object	Adjusts night-vision parameter for the perks handler.
perks.ping	List/Object	Adjusts ping parameter for the perks handler.
perks.virtual-inventory	List/Object	Adjusts virtual-inventory parameter for the perks handler.

---