Skip to main content

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 PathDefault SettingTechnical Functionality & Usage
storeObjectRoot configuration section managing store subsystem.
store.enabledtrueAdjusts enabled parameter for the store handler.
store.url"https://store.bharatmc.net"Adjusts url parameter for the store handler.
store.submodulesList/ObjectAdjusts submodules parameter for the store handler.
store.apiList/ObjectAdjusts api parameter for the store handler.
prefix"<gradient:#FF9100:#FFBA00><bold>BHARATMC</bold></gradient> <dark_gray>➥</dark_gray> "Root configuration section managing prefix subsystem.
messagesObjectRoot configuration section managing messages subsystem.
messages.separator"<dark_gray>----------------------------------------</dark_gray>"Adjusts separator parameter for the messages handler.
messages.infoList/ObjectAdjusts info parameter for the messages handler.
messages.purchaseList/ObjectAdjusts purchase parameter for the messages handler.
messages.broadcastList/ObjectAdjusts 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 PathDefault SettingTechnical Functionality & Usage
prefix"<gradient:#FF9100:#FFBA00><bold>BHARATMC</bold></gradient> <dark_gray>➥</dark_gray> "Root configuration section managing prefix subsystem.
storeObjectRoot 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.infoList/ObjectAdjusts info parameter for the store handler.
purchaseObjectRoot configuration section managing purchase subsystem.
purchase.successList/ObjectAdjusts success parameter for the purchase handler.
purchase.processingList/ObjectAdjusts processing parameter for the purchase handler.
purchase.failedList/ObjectAdjusts failed parameter for the purchase handler.
purchase.inventory_fullList/ObjectAdjusts inventory_full parameter for the purchase handler.
broadcastObjectRoot configuration section managing broadcast subsystem.
broadcast.donor_announcementList/ObjectAdjusts donor_announcement parameter for the broadcast handler.
bmcObjectRoot 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.balanceList/ObjectAdjusts balance parameter for the bmc handler.
bmc.payList/ObjectAdjusts pay parameter for the bmc handler.
bmc.giveList/ObjectAdjusts give parameter for the bmc handler.
bmc.takeList/ObjectAdjusts take parameter for the bmc handler.
bmc.setList/ObjectAdjusts set parameter for the bmc handler.
bmc.checkList/ObjectAdjusts check parameter for the bmc handler.
bmc.helpList/ObjectAdjusts help parameter for the bmc handler.
voteObjectRoot configuration section managing vote subsystem.
vote.linkList/ObjectAdjusts link parameter for the vote handler.
vote.rewardsList/ObjectAdjusts rewards parameter for the vote handler.
vote.votepartyList/ObjectAdjusts 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 PathDefault SettingTechnical Functionality & Usage
enabledtrueRoot configuration section managing enabled subsystem.
chatObjectRoot configuration section managing chat subsystem.
chat.mentionList/ObjectAdjusts mention parameter for the chat handler.
chat.direct-message-receivedList/ObjectAdjusts direct-message-received parameter for the chat handler.
chat.direct-message-sentList/ObjectAdjusts direct-message-sent parameter for the chat handler.
guiObjectRoot configuration section managing gui subsystem.
gui.clickList/ObjectAdjusts click parameter for the gui handler.
gui.successList/ObjectAdjusts success parameter for the gui handler.
gui.deniedList/ObjectAdjusts denied parameter for the gui handler.
gui.page-changeList/ObjectAdjusts page-change parameter for the gui handler.
gui.closeList/ObjectAdjusts close parameter for the gui handler.
teleportationObjectRoot configuration section managing teleportation subsystem.
teleportation.successList/ObjectAdjusts success parameter for the teleportation handler.
teleportation.warmup-tickList/ObjectAdjusts warmup-tick parameter for the teleportation handler.
teleportation.warmup-cancelledList/ObjectAdjusts warmup-cancelled parameter for the teleportation handler.
teleportation.void-recoveryList/ObjectAdjusts void-recovery parameter for the teleportation handler.
teleportation.enderpearl-throwList/ObjectAdjusts enderpearl-throw parameter for the teleportation handler.
teleportation.enderpearl-landList/ObjectAdjusts enderpearl-land parameter for the teleportation handler.
moderationObjectRoot configuration section managing moderation subsystem.
moderation.staff-alertList/ObjectAdjusts staff-alert parameter for the moderation handler.
moderation.report-submittedList/ObjectAdjusts report-submitted parameter for the moderation handler.
moderation.player-frozenList/ObjectAdjusts player-frozen parameter for the moderation handler.
moderation.player-jailedList/ObjectAdjusts player-jailed parameter for the moderation handler.
moderation.direct-alertList/ObjectAdjusts direct-alert parameter for the moderation handler.
moderation.broadcastList/ObjectAdjusts broadcast parameter for the moderation handler.
perksObjectRoot configuration section managing perks subsystem.
perks.repairList/ObjectAdjusts repair parameter for the perks handler.
perks.healList/ObjectAdjusts heal parameter for the perks handler.
perks.night-visionList/ObjectAdjusts night-vision parameter for the perks handler.
perks.pingList/ObjectAdjusts ping parameter for the perks handler.
perks.virtual-inventoryList/ObjectAdjusts virtual-inventory parameter for the perks handler.