Coin Shop & Cosmetics

The Coin Shop is BharatCore's native cosmetic and perk marketplace. Players exchange BMC Coins (earned via webstore checkouts, playtime milestones, or staff events) for cosmetic tags, chat colors, glowing shaders, and temporary perks.

Shop Architecture & Submodules

The coinshop module connects into dedicated sub-configs inside coinshop/:

coinshop/
├── coinshop.yml     # Master category hierarchy, GUI title, item layout
├── chatcolor.yml    # MiniMessage RGB gradient and hex chat colors
├── namecolor.yml    # Tablist & display name colors
├── tags.yml         # Formatted custom tags & badges
├── glow.yml         # Outline shader colors
├── flyperks.yml     # Flight bank minute/hour purchase packages
├── godperks.yml     # Temporary invulnerability perks
└── perks.yml        # Utility perks (e.g. keepXP, portable crafting)

In-Game Dynamic Editor

Staff do not need to manually edit YAML files while the server is live. BharatCore includes an interactive in-game editor menu:

Editor Command	Permission	Description
`/coinshop editor`	`bharatcore.coinshop.admin`	Opens master GUI to edit categories, add items, set costs.
`/coinshop reload`	`bharatcore.coinshop.admin`	Hot-reloads all `coinshop/*.yml` configurations from disk.
`/coinshop`	`bharatcore.coinshop.use`	Opens the player shopping catalog.

Currency Transaction Engine

Atomic Deduction: Purchases execute an atomic database transaction. If inventory space is missing or network times out, coins are immediately refunded.
Permanent vs Leased Perks: Items support both one-time permanent unlocks (e.g. Chat Tags) and consumable/timed bonuses (e.g. 1 hour flight time added to Flight Bank).

title: "BharatCore: Coin Shop & Cosmetic Perks" description: "Exhaustive YAML configurations with verbatim syntax and detailed option breakdowns."

Detailed line-by-line configuration and option reference for BharatCore: Coin Shop & Cosmetic Perks.

📄 `coinshop\coinshop.yml`

Configuration file managing coinshop.yml in BharatCore.

Full YAML Source (`coinshop\coinshop.yml`)

# ============================================================
#  BharatCore Coin Shop Configuration
#  plugins/Bharat-core/coinshop/coinshop.yml
#
#  Items are auto-discovered from the cosmetic menu configs.
#  Individual prices and purchase actions/commands are defined
#  directly inside the source menu configs (e.g., tagsmenu.yml,
#  chatcolormenu.yml, namecolormenu.yml, glowmenu.yml, perks.yml).
#  
#  This file only configures category slots, names, and lore
#  for the main shop menu.
#
#  Disable the whole module: modules.coinshop: false in config.yml
#  Disable one category:     set  enabled: false  on that category.
# ============================================================

main-menu:
  title: '<dark_gray>✦ <#FFD300>BMC Coinshop'
  size: 27
  # Slot to show live coin balance (set -1 to hide)
  balance-slot: 4
  # Slot 22 is removed from filler-slots to allow the Perks category button
  # Slot 24 is removed from filler-slots to allow the Fly Time category button
  # Slot 26 is removed from filler-slots to allow the God Mode category button
  filler-slots: [0, 1, 2, 3, 5, 6, 7, 8, 18, 19, 20, 21, 23, 25]

# ============================================================
# CATEGORIES
# Each category maps to an existing cosmetic/perk system.
# Items within are auto-read from the corresponding config.
# ============================================================
categories:

  # ────────────────────────────────────────────────────────────
  # TAGS  (source: coinshop/tags.yml → tags.*)
  # Permission granted: bharatcore.tag.<id>
  # ────────────────────────────────────────────────────────────
  tags:
    enabled: true
    slot: 10
    material: NAME_TAG
    name: '<yellow><bold>Player Tags'
    title: '<dark_gray>✦ <yellow>Coinshop <dark_gray>| <white>Tags <gray>({page}/{max_page})'
    lore:
      - '<gray>Unique tags displayed'
      - '<gray>next to your name.'
      - ''
      - '<yellow>‣ Click to Browse'

  # ────────────────────────────────────────────────────────────
  # CHAT COLORS  (source: coinshop/chatcolor.yml)
  # Solid: bharatcore.chatcolor.solid.<id>
  # Gradient: bharatcore.chatcolor.gradient.<id>
  # ────────────────────────────────────────────────────────────
  chatcolor:
    enabled: true
    slot: 12
    material: RED_DYE
    name: '<red><bold>Chat Colors'
    title: '<dark_gray>✦ <#FFD300>Coinshop <dark_gray>| <white>Chat Colors <gray>({page}/{max_page})'
    lore:
      - '<gray>Color your chat messages'
      - '<gray>with solid colors or gradients.'
      - ''
      - '<yellow>‣ Click to Browse'

  # ────────────────────────────────────────────────────────────
  # NAME COLORS  (source: coinshop/namecolor.yml)
  # Permission granted: bharatcore.namecolor.<id>
  # ────────────────────────────────────────────────────────────
  namecolor:
    enabled: true
    slot: 14
    material: PAPER
    name: '<aqua><bold>Name Colors'
    title: '<dark_gray>✦ <#FFD300>Coinshop <dark_gray>| <white>Name Colors <gray>({page}/{max_page})'
    lore:
      - '<gray>Apply a custom color or'
      - '<gray>gradient to your display name.'
      - ''
      - '<yellow>‣ Click to Browse'

  # ────────────────────────────────────────────────────────────
  # GLOW  (source: coinshop/glow.yml)
  # Permission granted: bharatcore.glow.color.<id>
  # ────────────────────────────────────────────────────────────
  glow:
    enabled: true
    slot: 16
    material: GLOWSTONE_DUST
    name: '<white><bold>Glow Colors'
    title: '<dark_gray>✦ <#FFD300>Coinshop <dark_gray>| <white>Glow Colors <gray>({page}/{max_page})'
    lore:
      - '<gray>Unlock a colored glow'
      - '<gray>visible to all players.'
      - ''
      - '<yellow>‣ Click to Browse'

  # ────────────────────────────────────────────────────────────
  # PERKS (source: coinshop/perks.yml)
  # ────────────────────────────────────────────────────────────
  perks:
    enabled: true
    slot: 22
    material: EMERALD
    name: '<green><bold>Survival Perks'
    title: '<dark_gray>✦ <#FFD300>Coinshop <dark_gray>| <white>Perks <gray>({page}/{max_page})'
    lore:
      - '<gray>Purchase permanent commands'
      - '<yellow>‣ Click to Browse'

  # ────────────────────────────────────────────────────────────
  # FLY TIME
  # ────────────────────────────────────────────────────────────
  flyshop:
    enabled: true
    slot: 24
    material: FEATHER
    name: '<white><bold>Fly Time'
    title: '<dark_gray>✦ <#FFD300>Coinshop <dark_gray>| <white>Fly Time <gray>({page}/{max_page})'
    lore:
      - '<gray>Purchase temporary fly time'
      - '<gray>to use on your land.'
      - ''
      - '<yellow>‣ Click to Browse'

  # ────────────────────────────────────────────────────────────
  # GOD MODE
  # ────────────────────────────────────────────────────────────
  godshop:
    enabled: true
    slot: 26
    material: ENCHANTED_GOLDEN_APPLE
    name: '<white><bold>God Mode Time'
    title: '<dark_gray>✦ <#FFD300>Coinshop <dark_gray>| <white>God Mode Time <gray>({page}/{max_page})'
    lore:
      - '<gray>Purchase temporary God Mode'
      - '<gray>to use in-game.'
      - ''
      - '<yellow>‣ Click to Browse'

Key Options & Behavior Breakdown

Option / Key Path	Default Setting	Technical Functionality & Usage
`main-menu`	`Object`	Root configuration section managing `main-menu` subsystem.
`main-menu.title`	`'<dark_gray>✦ <#FFD300>BMC Coinshop'`	Adjusts `title` parameter for the `main-menu` handler.
`main-menu.size`	`27`	Adjusts `size` parameter for the `main-menu` handler.
`main-menu.balance-slot`	`4`	Adjusts `balance-slot` parameter for the `main-menu` handler.
`main-menu.filler-slots`	`[0, 1, 2, 3, 5, 6, 7, 8, 18, 19, 20, 21, 23, 25]`	Adjusts `filler-slots` parameter for the `main-menu` handler.
`categories`	`Object`	Root configuration section managing `categories` subsystem.
`categories.tags`	`List/Object`	Adjusts `tags` parameter for the `categories` handler.
`categories.chatcolor`	`List/Object`	Adjusts `chatcolor` parameter for the `categories` handler.
`categories.namecolor`	`List/Object`	Adjusts `namecolor` parameter for the `categories` handler.
`categories.glow`	`List/Object`	Adjusts `glow` parameter for the `categories` handler.
`categories.perks`	`List/Object`	Adjusts `perks` parameter for the `categories` handler.
`categories.flyshop`	`List/Object`	Adjusts `flyshop` parameter for the `categories` handler.
`categories.godshop`	`List/Object`	Adjusts `godshop` parameter for the `categories` handler.

📄 `coinshop\chatcolor.yml`

Configuration file managing chatcolor.yml in BharatCore.

Full YAML Source (`coinshop\chatcolor.yml`)

title: "<dark_gray>ChatColor Selector"
size: 54

filler:
  material: BLACK_STAINED_GLASS_PANE
  name: " "
  slots: [0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 17, 18, 26, 27, 35, 36, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53]

close-button:
  slot: 49
  material: BARRIER
  name: "<red><bold>CLOSE"
  lore:
    - "<gray>Click to close"

reset-button:
  slot: 48
  material: CAULDRON
  name: "<red><bold>RESET COLOR"
  lore:
    - "<gray>Click to reset back to default"

switch-button:
  slot: 50
  material: PAINTING
  name_solid: "<gradient:#FFD700:#FFA500><bold>VIEW GRADIENTS"
  name_gradient: "<gradient:#00BFFF:#1E90FF><bold>VIEW SOLID COLORS"
  lore:
    - "<gray>Click to switch selection mode"

toggle-button:
  slot: 51

# -------------------------------------------------------
# price:    (integer) — BMC Coin cost in the coinshop.
#           Remove this field to hide the item from shop.
# commands: (list)    — DeluxeMenus-style actions on purchase.
#           Leave empty to auto-grant the permission node.
# -------------------------------------------------------

# permission defaults to: bharatcore.chatcolor.solid.<id>
solid-colors:
  # ================= LOW TIER: 29 Rs = 348 Coins =================
  white:
    slot: 24
    material: WHITE_DYE
    name: "<white><bold>WHITE"
    color-tag: "<white>"
    price: 0
    lore: ["<gray>Set your chat color to <dark_red>Dark Red"]
  red:
    slot: 11
    material: RED_DYE
    name: "<red><bold>RED"
    color-tag: "<red>"
    price: 588
    lore: ["<gray>Set your chat color to <red>Red"]
  gold:
    slot: 12
    material: GOLD_INGOT
    name: "<gold><bold>GOLD"
    color-tag: "<gold>"
    price: 588
    lore: ["<gray>Set your chat color to <gold>Gold"]
  yellow:
    slot: 13
    material: YELLOW_DYE
    name: "<yellow><bold>YELLOW"
    color-tag: "<yellow>"
    price: 588
    lore: ["<gray>Set your chat color to <yellow>Yellow"]
  dark_green:
    slot: 14
    material: GREEN_CONCRETE
    name: "<dark_green><bold>DARK GREEN"
    color-tag: "<dark_green>"
    price: 588
    lore: ["<gray>Set your chat color to <dark_green>Dark Green"]
  green:
    slot: 15
    material: LIME_DYE
    name: "<green><bold>GREEN"
    color-tag: "<green>"
    price: 588
    lore: ["<gray>Set your chat color to <green>Green"]
  aqua:
    slot: 16
    material: LIGHT_BLUE_DYE
    name: "<aqua><bold>AQUA"
    color-tag: "<aqua>"
    price: 588
    lore: ["<gray>Set your chat color to <aqua>Aqua"]
  dark_aqua:
    slot: 19
    material: CYAN_DYE
    name: "<dark_aqua><bold>DARK AQUA"
    color-tag: "<dark_aqua>"
    price: 588
    lore: ["<gray>Set your chat color to <dark_aqua>Dark Aqua"]
  dark_blue:
    slot: 20
    material: BLUE_CONCRETE
    name: "<dark_blue><bold>DARK BLUE"
    color-tag: "<dark_blue>"
    price: 588
    lore: ["<gray>Set your chat color to <dark_blue>Dark Blue"]
  blue:
    slot: 21
    material: BLUE_DYE
    name: "<blue><bold>BLUE"
    color-tag: "<blue>"
    price: 588
    lore: ["<gray>Set your chat color to <blue>Blue"]
  light_purple:
    slot: 22
    material: PINK_DYE
    name: "<light_purple><bold>LIGHT PURPLE"
    color-tag: "<light_purple>"
    price: 588
    lore: ["<gray>Set your chat color to <light_purple>Pink"]

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

  cherry_blossom:
    slot: 31
    material: CHERRY_SAPLING
    name: "<gradient:#f2c6de:#f874ff:#f6c0ff:#ff68e8><bold>CHERRY BLOSSOM"
    color-tag: "<gradient:#f2c6de:#f874ff:#f6c0ff:#ff68e8>"
    price: 2388
    lore: ["<gray>Set your chat color to <gradient:#f2c6de:#ff68e8>Cherry"]
  vibrant_rainbow:
    slot: 33
    material: SPECTRAL_ARROW
    name: "<gradient:#ff0000:#ffa500:#ffff00:#008000:#0000ff:#4b0082:#ee82ee><bold>VIBRANT RAINBOW"
    color-tag: "<gradient:#ff0000:#ffa500:#ffff00:#008000:#0000ff:#4b0082:#ee82ee>"
    price: 2388
    lore: ["<gray>Set your chat color to <gradient:#ff0000:#ee82ee>Rainbow"]
  pastel_rainbow:
    slot: 34
    material: WHITE_STAINED_GLASS
    name: "<gradient:#ffadad:#ffd6a5:#fdffb6:#caffbf:#9bf6ff:#a0c4ff:#bdb2ff:#ffc6ff><bold>PASTEL RAINBOW"
    color-tag: "<gradient:#ffadad:#ffd6a5:#fdffb6:#caffbf:#9bf6ff:#a0c4ff:#bdb2ff:#ffc6ff>"
    price: 2388
    lore: ["<gray>Set your chat color to <gradient:#ffadad:#ffc6ff>Pastel"]
  blue_rainbow:
    slot: 37
    material: BLUE_STAINED_GLASS
    name: "<gradient:#5da7ee:#3574ff:#1b3cff:#3574ff><bold>BLUE RAINBOW"
    color-tag: "<gradient:#5da7ee:#3574ff:#1b3cff:#3574ff>"
    price: 2388
    lore: ["<gray>Set your chat color to <gradient:#5da7ee:#1b3cff>Blue Rain"]
  sunset_gradient:
    slot: 28
    material: ORANGE_DYE
    name: "<gradient:#ffbc68:#ff9364:#ff6878:#ef67b3:#d046f5><bold>SUNSET"
    color-tag: "<gradient:#ffbc68:#ff9364:#ff6878:#ef67b3:#d046f5>"
    price: 2388
    lore: ["<gray>Set your chat color to <gradient:#ffbc68:#d046f5>Sunset"]

Key Options & Behavior Breakdown

Option / Key Path	Default Setting	Technical Functionality & Usage
`title`	`"<dark_gray>ChatColor Selector"`	Root configuration section managing `title` subsystem.
`size`	`54`	Root configuration section managing `size` subsystem.
`filler`	`Object`	Root configuration section managing `filler` subsystem.
`filler.material`	`BLACK_STAINED_GLASS_PANE`	Adjusts `material` parameter for the `filler` handler.
`filler.name`	`" "`	Adjusts `name` parameter for the `filler` handler.
`filler.slots`	`[0, 1, 2, 3, 4, 5, 6, 7, 8, 9, 17, 18, 26, 27, 35, 36, 44, 45, 46, 47, 48, 49, 50, 51, 52, 53]`	Adjusts `slots` parameter for the `filler` handler.
`close-button`	`Object`	Root configuration section managing `close-button` subsystem.
`close-button.slot`	`49`	Adjusts `slot` parameter for the `close-button` handler.
`close-button.material`	`BARRIER`	Adjusts `material` parameter for the `close-button` handler.
`close-button.name`	`"<red><bold>CLOSE"`	Adjusts `name` parameter for the `close-button` handler.
`close-button.lore`	`List/Object`	Adjusts `lore` parameter for the `close-button` handler.
`reset-button`	`Object`	Root configuration section managing `reset-button` subsystem.
`reset-button.slot`	`48`	Adjusts `slot` parameter for the `reset-button` handler.
`reset-button.material`	`CAULDRON`	Adjusts `material` parameter for the `reset-button` handler.
`reset-button.name`	`"<red><bold>RESET COLOR"`	Adjusts `name` parameter for the `reset-button` handler.
`reset-button.lore`	`List/Object`	Adjusts `lore` parameter for the `reset-button` handler.
`switch-button`	`Object`	Root configuration section managing `switch-button` subsystem.
`switch-button.slot`	`50`	Adjusts `slot` parameter for the `switch-button` handler.
`switch-button.material`	`PAINTING`	Adjusts `material` parameter for the `switch-button` handler.
`switch-button.name_solid`	`"<gradient:#FFD700:#FFA500><bold>VIEW GRADIENTS"`	Adjusts `name_solid` parameter for the `switch-button` handler.
`switch-button.name_gradient`	`"<gradient:#00BFFF:#1E90FF><bold>VIEW SOLID COLORS"`	Adjusts `name_gradient` parameter for the `switch-button` handler.
`switch-button.lore`	`List/Object`	Adjusts `lore` parameter for the `switch-button` handler.
`toggle-button`	`Object`	Root configuration section managing `toggle-button` subsystem.
`toggle-button.slot`	`51`	Adjusts `slot` parameter for the `toggle-button` handler.
`solid-colors`	`Object`	Root configuration section managing `solid-colors` subsystem.
`solid-colors.white`	`List/Object`	Adjusts `white` parameter for the `solid-colors` handler.
`solid-colors.red`	`List/Object`	Adjusts `red` parameter for the `solid-colors` handler.
`solid-colors.gold`	`List/Object`	Adjusts `gold` parameter for the `solid-colors` handler.
`solid-colors.yellow`	`List/Object`	Adjusts `yellow` parameter for the `solid-colors` handler.
`solid-colors.dark_green`	`List/Object`	Adjusts `dark_green` parameter for the `solid-colors` handler.
`solid-colors.green`	`List/Object`	Adjusts `green` parameter for the `solid-colors` handler.
`solid-colors.aqua`	`List/Object`	Adjusts `aqua` parameter for the `solid-colors` handler.
`solid-colors.dark_aqua`	`List/Object`	Adjusts `dark_aqua` parameter for the `solid-colors` handler.
`solid-colors.dark_blue`	`List/Object`	Adjusts `dark_blue` parameter for the `solid-colors` handler.
`solid-colors.blue`	`List/Object`	Adjusts `blue` parameter for the `solid-colors` handler.
`solid-colors.light_purple`	`List/Object`	Adjusts `light_purple` parameter for the `solid-colors` handler.
`solid-colors.dark_purple`	`List/Object`	Adjusts `dark_purple` parameter for the `solid-colors` handler.
`gradients`	`Object`	Root configuration section managing `gradients` subsystem.
`gradients.fire`	`List/Object`	Adjusts `fire` parameter for the `gradients` handler.
`gradients.ocean`	`List/Object`	Adjusts `ocean` parameter for the `gradients` handler.
`gradients.sunset`	`List/Object`	Adjusts `sunset` parameter for the `gradients` handler.
`gradients.amethyst`	`List/Object`	Adjusts `amethyst` parameter for the `gradients` handler.
`gradients.toxic`	`List/Object`	Adjusts `toxic` parameter for the `gradients` handler.
`gradients.forest`	`List/Object`	Adjusts `forest` parameter for the `gradients` handler.
`gradients.lava`	`List/Object`	Adjusts `lava` parameter for the `gradients` handler.
`gradients.earth`	`List/Object`	Adjusts `earth` parameter for the `gradients` handler.
`gradients.rose`	`List/Object`	Adjusts `rose` parameter for the `gradients` handler.
`gradients.cyberpunk`	`List/Object`	Adjusts `cyberpunk` parameter for the `gradients` handler.
`gradients.neon`	`List/Object`	Adjusts `neon` parameter for the `gradients` handler.
`gradients.galaxy`	`List/Object`	Adjusts `galaxy` parameter for the `gradients` handler.

📄 `coinshop\namecolor.yml`

Configuration file managing namecolor.yml in BharatCore.

Full YAML Source (`coinshop\namecolor.yml`)

title: "<dark_gray>Name Color Selector - Page {page}/{max_page}"
size: 54

color-slots:
  - 10
  - 11
  - 12
  - 13
  - 14
  - 15
  - 16
  - 19
  - 20
  - 21
  - 22
  - 23
  - 24
  - 25
  - 28
  - 29
  - 30
  - 31
  - 32
  - 33
  - 34

filler:
  material: BLACK_STAINED_GLASS_PANE
  name: " "
  slots: [0,1,2,3,4,5,6,7,8,9, 17,18, 26,27, 35,36,37,38,39,40,41,42,43,44, 45,46,47,48,49,50,51,52,53]

next-page:
  slot: 50
  material: ARROW
  name: "<green>Next Page"

prev-page:
  slot: 48
  material: ARROW
  name: "<red>Previous Page"

close-button:
  slot: 49
  material: BARRIER
  name: "<red><bold>CLOSE"

reset-button:
  slot: 45
  material: CAULDRON
  name: "<red><bold>CLEAR NAME COLOR"
  lore:
    - "<gray>Click to reset to default name color."

status-lores:
  equipped:
    - ""
    - "<green>■ <bold>CURRENTLY EQUIPPED"
  unlocked:
    - ""
    - "<green>■ Status: Unlocked"
    - "<yellow>► Click to equip!"
  locked:
    - ""
    - "<red>■ Status: Locked"
    - "<#FFD300>₹ <white>Price: <#FFD300>{price} Coins"
    - "<gray>Click to purchase this name color!"

# ---------------------------------------------
# price:    (integer) — BMC Coin cost in the coinshop.
#           Remove this field to hide the item from shop.
# commands: (list)    — DeluxeMenus-style actions on purchase.
#           Leave empty to auto-grant the permission node: bharatcore.namecolor.<id>
# ---------------------------------------------
name-colors:
  # ================= LOW TIER SOLIDS: 29 Rs = 348 Coins =================
  white:
    name: "<white>White Name Color"
    tag-string: "<white>"
    display-material: WHITE_DYE
    price: 0
    lore:
      - "<gray>A clean, classic white name."
  gray:
    name: "<gray>Gray Name Color"
    tag-string: "<gray>"
    display-material: LIGHT_GRAY_DYE
    price: 0
    lore:
      - "<gray>A subtle gray name."
  dark_gray:
    name: "<dark_gray>Dark Gray Name Color"
    tag-string: "<dark_gray>"
    display-material: GRAY_DYE
    price: 348
    lore:
      - "<gray>A dark charcoal name."
  black:
    name: "<black>Black Name Color"
    tag-string: "<black>"
    display-material: BLACK_DYE
    price: 348
    lore:
      - "<gray>A deep, mysterious black name."

  # ================= MEDIUM TIER SOLIDS: 49 Rs = 588 Coins =================
  red:
    name: "<red>Red Name Color"
    tag-string: "<red>"
    display-material: RED_DYE
    price: 588
    lore:
      - "<gray>A vibrant ruby red name."
  dark_red:
    name: "<dark_red>Dark Red Name Color"
    tag-string: "<dark_red>"
    display-material: RED_DYE
    price: 588
    lore:
      - "<gray>A dark crimson name."
  gold:

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

    price: 2388
    lore:
      - "<gray>A deep, blood-red velvet aesthetic."

  # ================= PREMIUM / CHARITY GRADIENTS: 299 Rs = 3588 Coins =================
  beyond_blue_25:
    name: "<gradient:#59EAA4:#089CCC><bold>Beyond Blue $25"
    tag-string: "<gradient:#59EAA4:#089CCC>"
    price: 3588
    lore:
      - "<gray>A beautiful teal to ocean blue gradient."
  beyond_blue_300:
    name: "<gradient:#59EAA4:#CD03FF><bold>Beyond Blue $300"
    tag-string: "<gradient:#59EAA4:#CD03FF>"
    price: 3588
    lore:
      - "<gray>A teal to cosmic purple premium gradient."
  make_a_wish:
    name: "<gradient:#f74fdb:#940ee2><bold>Make-A-Wish"
    tag-string: "<gradient:#f74fdb:#940ee2>"
    price: 3588
    lore:
      - "<gray>A bright pink to royal purple charity gradient."
  special_effect:
    name: "<gradient:#ffd728:#ff7328><bold>SpecialEffect"
    tag-string: "<gradient:#ffd728:#ff7328>"
    price: 3588
    lore:
      - "<gray>A vibrant gold and orange charity gradient."
  water_org:
    name: "<gradient:#33E7FF:#0368FF><bold>Water.org"
    tag-string: "<gradient:#33E7FF:#0368FF>"
    price: 3588
    lore:
      - "<gray>A refreshing sky blue to deep blue gradient."

Key Options & Behavior Breakdown

Option / Key Path	Default Setting	Technical Functionality & Usage
`title`	`"<dark_gray>Name Color Selector - Page {page}/{max_page}"`	Root configuration section managing `title` subsystem.
`size`	`54`	Root configuration section managing `size` subsystem.
`color-slots`	`Object`	Root configuration section managing `color-slots` subsystem.
`filler`	`Object`	Root configuration section managing `filler` subsystem.
`filler.material`	`BLACK_STAINED_GLASS_PANE`	Adjusts `material` parameter for the `filler` handler.
`filler.name`	`" "`	Adjusts `name` parameter for the `filler` handler.
`filler.slots`	`[0,1,2,3,4,5,6,7,8,9, 17,18, 26,27, 35,36,37,38,39,40,41,42,43,44, 45,46,47,48,49,50,51,52,53]`	Adjusts `slots` parameter for the `filler` handler.
`next-page`	`Object`	Root configuration section managing `next-page` subsystem.
`next-page.slot`	`50`	Adjusts `slot` parameter for the `next-page` handler.
`next-page.material`	`ARROW`	Adjusts `material` parameter for the `next-page` handler.
`next-page.name`	`"<green>Next Page"`	Adjusts `name` parameter for the `next-page` handler.
`prev-page`	`Object`	Root configuration section managing `prev-page` subsystem.
`prev-page.slot`	`48`	Adjusts `slot` parameter for the `prev-page` handler.
`prev-page.material`	`ARROW`	Adjusts `material` parameter for the `prev-page` handler.
`prev-page.name`	`"<red>Previous Page"`	Adjusts `name` parameter for the `prev-page` handler.
`close-button`	`Object`	Root configuration section managing `close-button` subsystem.
`close-button.slot`	`49`	Adjusts `slot` parameter for the `close-button` handler.
`close-button.material`	`BARRIER`	Adjusts `material` parameter for the `close-button` handler.
`close-button.name`	`"<red><bold>CLOSE"`	Adjusts `name` parameter for the `close-button` handler.
`reset-button`	`Object`	Root configuration section managing `reset-button` subsystem.
`reset-button.slot`	`45`	Adjusts `slot` parameter for the `reset-button` handler.
`reset-button.material`	`CAULDRON`	Adjusts `material` parameter for the `reset-button` handler.
`reset-button.name`	`"<red><bold>CLEAR NAME COLOR"`	Adjusts `name` parameter for the `reset-button` handler.
`reset-button.lore`	`List/Object`	Adjusts `lore` parameter for the `reset-button` handler.
`status-lores`	`Object`	Root configuration section managing `status-lores` subsystem.
`status-lores.equipped`	`List/Object`	Adjusts `equipped` parameter for the `status-lores` handler.
`status-lores.unlocked`	`List/Object`	Adjusts `unlocked` parameter for the `status-lores` handler.
`status-lores.locked`	`List/Object`	Adjusts `locked` parameter for the `status-lores` handler.
`name-colors`	`Object`	Root configuration section managing `name-colors` subsystem.
`name-colors.white`	`List/Object`	Adjusts `white` parameter for the `name-colors` handler.
`name-colors.gray`	`List/Object`	Adjusts `gray` parameter for the `name-colors` handler.
`name-colors.dark_gray`	`List/Object`	Adjusts `dark_gray` parameter for the `name-colors` handler.
`name-colors.black`	`List/Object`	Adjusts `black` parameter for the `name-colors` handler.
`name-colors.red`	`List/Object`	Adjusts `red` parameter for the `name-colors` handler.
`name-colors.dark_red`	`List/Object`	Adjusts `dark_red` parameter for the `name-colors` handler.
`name-colors.gold`	`List/Object`	Adjusts `gold` parameter for the `name-colors` handler.
`name-colors.yellow`	`List/Object`	Adjusts `yellow` parameter for the `name-colors` handler.
`name-colors.green`	`List/Object`	Adjusts `green` parameter for the `name-colors` handler.
`name-colors.dark_green`	`List/Object`	Adjusts `dark_green` parameter for the `name-colors` handler.
`name-colors.aqua`	`List/Object`	Adjusts `aqua` parameter for the `name-colors` handler.
`name-colors.dark_aqua`	`List/Object`	Adjusts `dark_aqua` parameter for the `name-colors` handler.
`name-colors.blue`	`List/Object`	Adjusts `blue` parameter for the `name-colors` handler.
`name-colors.dark_blue`	`List/Object`	Adjusts `dark_blue` parameter for the `name-colors` handler.
`name-colors.light_purple`	`List/Object`	Adjusts `light_purple` parameter for the `name-colors` handler.
`name-colors.dark_purple`	`List/Object`	Adjusts `dark_purple` parameter for the `name-colors` handler.
`name-colors.fire`	`List/Object`	Adjusts `fire` parameter for the `name-colors` handler.
`name-colors.ocean`	`List/Object`	Adjusts `ocean` parameter for the `name-colors` handler.
`name-colors.sunset`	`List/Object`	Adjusts `sunset` parameter for the `name-colors` handler.
`name-colors.amethyst`	`List/Object`	Adjusts `amethyst` parameter for the `name-colors` handler.
`name-colors.toxic`	`List/Object`	Adjusts `toxic` parameter for the `name-colors` handler.

📄 `coinshop\tags.yml`

Configuration file managing tags.yml in BharatCore.

Full YAML Source (`coinshop\tags.yml`)

title: "<dark_gray>Tags Selector - Page {page}/{max_page}"
size: 54

# The slots where tags will be dynamically populated.
tag-slots:
  - 10
  - 11
  - 12
  - 13
  - 14
  - 15
  - 16
  - 19
  - 20
  - 21
  - 22
  - 23
  - 24
  - 25
  - 28
  - 29
  - 30
  - 31
  - 32
  - 33
  - 34

filler:
  material: BLACK_STAINED_GLASS_PANE
  name: " "
  slots: [0,1,2,3,4,5,6,7,8,9, 17,18, 26,27, 35,36,37,38,39,40,41,42,43,44, 47,51,52,53]

toggle-button:
  slot: 46

next-page:
  slot: 50
  material: ARROW
  name: "<green>Next Page"

prev-page:
  slot: 48
  material: ARROW
  name: "<red>Previous Page"

close-button:
  slot: 49
  material: BARRIER
  name: "<red><bold>CLOSE"

reset-button:
  slot: 45
  material: CAULDRON
  name: "<red><bold>CLEAR TAG"
  lore:
    - "<gray>Click to remove your current tag"

# Global Lores injected at the bottom of the item dynamically
status-lores:
  equipped:
    - ""
    - "<green>■ <bold>CURRENTLY EQUIPPED"
  unlocked:
    - ""
    - "<green>■ Status: Unlocked"
    - "<yellow>► Click to equip!"
  locked:
    - ""
    - "<red>■ Status: Locked"
    - "<#FFD300>₹ <white>Price: <#FFD300>{price} Coins"
    - "<gray>Click to purchase this tag!"

# ---------------------------------------------
# Tag definitions
# ---------------------------------------------
# price:    (integer) — coin cost in the coinshop. Remove to hide from shop.
# commands: (list)    — optional DeluxeMenus-style actions executed on purchase.
#           If omitted, the shop auto-grants the 'permission' node.
#   Supported:  [givepermission] <node>
#               [console] <command>
#               [player] <command>
#               [message] <text>
# permission: override default bharatcore.tag.<id>
# ---------------------------------------------
# ---------------------------------------------
# Tag definitions
# ---------------------------------------------
tags:
  # ================= COMMON TAGS: 200 Coins =================
  noob:
    name: '<#808080><bold>Noob Tag'
    tag-string: "&8[&7ɴ&#808080ᴏ&#909090ᴏ&#A0A0A0ʙ&8]"
    permission: "bharatcore.tag.noob"
    price: 200
    lore:
      - "<gray>Let everyone know your status."
    commands:
      - "[givepermission] bharatcore.tag.noob"

  gamer:
    name: '<#00FF88><bold>Gamer Tag'
    tag-string: "&8[&#00FF88ɢ&#1BFF94ᴀ&#37FF9Fᴍ&#52FFAAᴇ&#6EFFB5ʀ&8]"
    permission: "bharatcore.tag.gamer"
    price: 200
    lore:
      - "<gray>True gamers only."
    commands:
      - "[givepermission] bharatcore.tag.gamer"

  grinder:
    name: '<#FFAA00><bold>Grinder Tag'
    tag-string: "&8[&#FFAA00ɢ&#FFB41Aʀ&#FFBE33ɪ&#FFC84Dɴ&#FFD266ᴅ&#FFDC80ᴇ&#FFE699ʀ&8]"
    permission: "bharatcore.tag.grinder"
    price: 200
    lore:
      - "<gray>Respect the daily grind."
    commands:
      - "[givepermission] bharatcore.tag.grinder"

  survival:

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

    price: 2000
    lore:
      - "<gray>Luck favors you."
      - "<gold>Unlock everything."
      - ""
      - "<yellow>Click to equip!"
    commands:
      - "[givepermission] bharatcore.tag.keyall"

  poseidon:
    name: '<#00FFEA><bold>Poseidon Tag'
    tag-string: "&#00FFEAᴘ&#16FFE8ᴏ&#2DFFE5ꜱ&#43FFE3ᴇ&#53F7E6ɪ&#5DE8EDᴅ&#67D8F5ᴏ&#71C9FCɴ"
    permission: "bharatcore.tag.poseidon"
    price: 2000
    lore:
      - "<gray>Ruler of the seas."
      - "<aqua>Power flows like water."
      - ""
      - "<yellow>Click to equip!"
    commands:
      - "[givepermission] bharatcore.tag.poseidon"

  premium:
    name: '<#FFD700><bold>Premium Tag'
    tag-string: "&#FFD700ᴘ&#FFC300ʀ&#FFAF00ᴇ&#FF9B00ᴍ&#FF8700ɪ&#FF7300ᴜ&#FF5F00ᴍ"
    permission: "bharatcore.tag.premium"
    price: 2000
    lore:
      - "<gray>Top-tier status."
      - "<gold>Only for the elite."
      - ""
      - "<yellow>Click to equip!"
    commands:
      - "[givepermission] bharatcore.tag.premium"

Key Options & Behavior Breakdown

Option / Key Path	Default Setting	Technical Functionality & Usage
`title`	`"<dark_gray>Tags Selector - Page {page}/{max_page}"`	Root configuration section managing `title` subsystem.
`size`	`54`	Root configuration section managing `size` subsystem.
`tag-slots`	`Object`	Root configuration section managing `tag-slots` subsystem.
`filler`	`Object`	Root configuration section managing `filler` subsystem.
`filler.material`	`BLACK_STAINED_GLASS_PANE`	Adjusts `material` parameter for the `filler` handler.
`filler.name`	`" "`	Adjusts `name` parameter for the `filler` handler.
`filler.slots`	`[0,1,2,3,4,5,6,7,8,9, 17,18, 26,27, 35,36,37,38,39,40,41,42,43,44, 47,51,52,53]`	Adjusts `slots` parameter for the `filler` handler.
`toggle-button`	`Object`	Root configuration section managing `toggle-button` subsystem.
`toggle-button.slot`	`46`	Adjusts `slot` parameter for the `toggle-button` handler.
`next-page`	`Object`	Root configuration section managing `next-page` subsystem.
`next-page.slot`	`50`	Adjusts `slot` parameter for the `next-page` handler.
`next-page.material`	`ARROW`	Adjusts `material` parameter for the `next-page` handler.
`next-page.name`	`"<green>Next Page"`	Adjusts `name` parameter for the `next-page` handler.
`prev-page`	`Object`	Root configuration section managing `prev-page` subsystem.
`prev-page.slot`	`48`	Adjusts `slot` parameter for the `prev-page` handler.
`prev-page.material`	`ARROW`	Adjusts `material` parameter for the `prev-page` handler.
`prev-page.name`	`"<red>Previous Page"`	Adjusts `name` parameter for the `prev-page` handler.
`close-button`	`Object`	Root configuration section managing `close-button` subsystem.
`close-button.slot`	`49`	Adjusts `slot` parameter for the `close-button` handler.
`close-button.material`	`BARRIER`	Adjusts `material` parameter for the `close-button` handler.
`close-button.name`	`"<red><bold>CLOSE"`	Adjusts `name` parameter for the `close-button` handler.
`reset-button`	`Object`	Root configuration section managing `reset-button` subsystem.
`reset-button.slot`	`45`	Adjusts `slot` parameter for the `reset-button` handler.
`reset-button.material`	`CAULDRON`	Adjusts `material` parameter for the `reset-button` handler.
`reset-button.name`	`"<red><bold>CLEAR TAG"`	Adjusts `name` parameter for the `reset-button` handler.
`reset-button.lore`	`List/Object`	Adjusts `lore` parameter for the `reset-button` handler.
`status-lores`	`Object`	Root configuration section managing `status-lores` subsystem.
`status-lores.equipped`	`List/Object`	Adjusts `equipped` parameter for the `status-lores` handler.
`status-lores.unlocked`	`List/Object`	Adjusts `unlocked` parameter for the `status-lores` handler.
`status-lores.locked`	`List/Object`	Adjusts `locked` parameter for the `status-lores` handler.
`tags`	`Object`	Root configuration section managing `tags` subsystem.
`tags.noob`	`List/Object`	Adjusts `noob` parameter for the `tags` handler.
`tags.gamer`	`List/Object`	Adjusts `gamer` parameter for the `tags` handler.
`tags.grinder`	`List/Object`	Adjusts `grinder` parameter for the `tags` handler.
`tags.survival`	`List/Object`	Adjusts `survival` parameter for the `tags` handler.
`tags.rabbit`	`List/Object`	Adjusts `rabbit` parameter for the `tags` handler.
`tags.fishy`	`List/Object`	Adjusts `fishy` parameter for the `tags` handler.
`tags.leaflet`	`List/Object`	Adjusts `leaflet` parameter for the `tags` handler.
`tags.spring`	`List/Object`	Adjusts `spring` parameter for the `tags` handler.
`tags.minecraft`	`List/Object`	Adjusts `minecraft` parameter for the `tags` handler.
`tags.maze`	`List/Object`	Adjusts `maze` parameter for the `tags` handler.
`tags.copper`	`List/Object`	Adjusts `copper` parameter for the `tags` handler.
`tags.apple`	`List/Object`	Adjusts `apple` parameter for the `tags` handler.
`tags.pear`	`List/Object`	Adjusts `pear` parameter for the `tags` handler.
`tags.male`	`List/Object`	Adjusts `male` parameter for the `tags` handler.
`tags.female`	`List/Object`	Adjusts `female` parameter for the `tags` handler.
`tags.striker`	`List/Object`	Adjusts `striker` parameter for the `tags` handler.
`tags.ace`	`List/Object`	Adjusts `ace` parameter for the `tags` handler.
`tags.trader`	`List/Object`	Adjusts `trader` parameter for the `tags` handler.
`tags.wealthy`	`List/Object`	Adjusts `wealthy` parameter for the `tags` handler.

📄 `coinshop\glow.yml`

Configuration file managing glow.yml in BharatCore.

Full YAML Source (`coinshop\glow.yml`)

title: "<dark_gray>Glow Selector"
size: 36

# List of colors to display in the menu
# Internal names must match NamedTextColor (white, gray, red, etc.)
# price:    (integer) — BMC Coin cost in the coinshop.
#           Remove this field to hide the item from shop.
# commands: (list)    — DeluxeMenus-style actions on purchase.
#           Leave empty to auto-grant the permission node: bharatcore.glow.color.<id>
colors:
  # ================= LOW TIER: 29 Rs = 348 Coins =================
  white:
    display-name: "<white>White Glow"
    material: WHITE_STAINED_GLASS
    slot: 10
    price: 0
  gray:
    display-name: "<gray>Gray Glow"
    material: LIGHT_GRAY_STAINED_GLASS
    slot: 11
    price: 348
  dark_gray:
    display-name: "<dark_gray>Dark Gray Glow"
    material: GRAY_STAINED_GLASS
    slot: 12
    price: 348
  black:
    display-name: "<black>Black Glow"
    material: BLACK_STAINED_GLASS
    slot: 13
    price: 348

  # ================= MEDIUM TIER: 49 Rs = 588 Coins =================
  red:
    display-name: "<red>Red Glow"
    material: RED_STAINED_GLASS
    slot: 14
    price: 588
  dark_red:
    display-name: "<dark_red>Dark Red Glow"
    material: RED_STAINED_GLASS
    slot: 15
    price: 588
  gold:
    display-name: "<gold>Gold Glow"
    material: ORANGE_STAINED_GLASS
    slot: 16
    price: 588
  yellow:
    display-name: "<yellow>Yellow Glow"
    material: YELLOW_STAINED_GLASS
    slot: 19
    price: 588
  green:
    display-name: "<green>Green Glow"
    material: GREEN_STAINED_GLASS
    slot: 20
    price: 588
  dark_green:
    display-name: "<dark_green>Dark Green Glow"
    material: GREEN_STAINED_GLASS
    slot: 21
    price: 588

  # ================= HIGH TIER: 69 Rs = 828 Coins =================
  aqua:
    display-name: "<aqua>Aqua Glow"
    material: CYAN_STAINED_GLASS
    slot: 22
    price: 828
  dark_aqua:
    display-name: "<dark_aqua>Dark Aqua Glow"
    material: CYAN_STAINED_GLASS
    slot: 23
    price: 828
  blue:
    display-name: "<blue>Blue Glow"
    material: BLUE_STAINED_GLASS
    slot: 24
    price: 828
  dark_blue:
    display-name: "<dark_blue>Dark Blue Glow"
    material: BLUE_STAINED_GLASS
    slot: 25
    price: 828

  # ================= VERY PREMIUM TIER: 199 Rs = 2388 Coins =================
  rainbow:
    display-name: "<gradient:#FF0000:#FFFF00:#00FF00:#00FFFF:#0000FF:#FF00FF>Rainbow Glow"
    material: SPECTRAL_ARROW
    slot: 26
    price: 2388

status-lores:
  click-to-select: "<gray>Left-Click to select this color!"
  currently-selected: "<green>✔ Currently selected"
  locked: "<red>Locked (No Permission)"

disable-button:
  slot: 31
  material: BARRIER
  name: "<red><bold>DISABLE GLOW"
  lore:
    - "<gray>Click to turn off your glow effect."

filler:
  material: GRAY_STAINED_GLASS_PANE
  name: " "

Key Options & Behavior Breakdown

Option / Key Path	Default Setting	Technical Functionality & Usage
`title`	`"<dark_gray>Glow Selector"`	Root configuration section managing `title` subsystem.
`size`	`36`	Root configuration section managing `size` subsystem.
`colors`	`Object`	Root configuration section managing `colors` subsystem.
`colors.white`	`List/Object`	Adjusts `white` parameter for the `colors` handler.
`colors.gray`	`List/Object`	Adjusts `gray` parameter for the `colors` handler.
`colors.dark_gray`	`List/Object`	Adjusts `dark_gray` parameter for the `colors` handler.
`colors.black`	`List/Object`	Adjusts `black` parameter for the `colors` handler.
`colors.red`	`List/Object`	Adjusts `red` parameter for the `colors` handler.
`colors.dark_red`	`List/Object`	Adjusts `dark_red` parameter for the `colors` handler.
`colors.gold`	`List/Object`	Adjusts `gold` parameter for the `colors` handler.
`colors.yellow`	`List/Object`	Adjusts `yellow` parameter for the `colors` handler.
`colors.green`	`List/Object`	Adjusts `green` parameter for the `colors` handler.
`colors.dark_green`	`List/Object`	Adjusts `dark_green` parameter for the `colors` handler.
`colors.aqua`	`List/Object`	Adjusts `aqua` parameter for the `colors` handler.
`colors.dark_aqua`	`List/Object`	Adjusts `dark_aqua` parameter for the `colors` handler.
`colors.blue`	`List/Object`	Adjusts `blue` parameter for the `colors` handler.
`colors.dark_blue`	`List/Object`	Adjusts `dark_blue` parameter for the `colors` handler.
`colors.rainbow`	`List/Object`	Adjusts `rainbow` parameter for the `colors` handler.
`status-lores`	`Object`	Root configuration section managing `status-lores` subsystem.
`status-lores.click-to-select`	`"<gray>Left-Click to select this color!"`	Adjusts `click-to-select` parameter for the `status-lores` handler.
`status-lores.currently-selected`	`"<green>✔ Currently selected"`	Adjusts `currently-selected` parameter for the `status-lores` handler.
`status-lores.locked`	`"<red>Locked (No Permission)"`	Adjusts `locked` parameter for the `status-lores` handler.
`disable-button`	`Object`	Root configuration section managing `disable-button` subsystem.
`disable-button.slot`	`31`	Adjusts `slot` parameter for the `disable-button` handler.
`disable-button.material`	`BARRIER`	Adjusts `material` parameter for the `disable-button` handler.
`disable-button.name`	`"<red><bold>DISABLE GLOW"`	Adjusts `name` parameter for the `disable-button` handler.
`disable-button.lore`	`List/Object`	Adjusts `lore` parameter for the `disable-button` handler.
`filler`	`Object`	Root configuration section managing `filler` subsystem.
`filler.material`	`GRAY_STAINED_GLASS_PANE`	Adjusts `material` parameter for the `filler` handler.
`filler.name`	`" "`	Adjusts `name` parameter for the `filler` handler.

📄 `coinshop\flyperks.yml`

Configuration file managing flyperks.yml in BharatCore.

Full YAML Source (`coinshop\flyperks.yml`)

items:
  fly_1h:
    name: '<white>1 Hour Fly Time'
    material: FEATHER
    price: 500
    lore:
      - '<gray>Add 1 hour of flight time'
      - '<gray>to your account.'
    commands:
      - 'fly addtime %player% 3600'
  fly_3h:
    name: '<white>3 Hours Fly Time'
    material: FEATHER
    price: 1200
    lore:
      - '<gray>Add 3 hours of flight time'
      - '<gray>to your account.'
    commands:
      - 'fly addtime %player% 10800'
  fly_12h:
    name: '<white>12 Hours Fly Time'
    material: FEATHER
    price: 4500
    lore:
      - '<gray>Add 12 hours of flight time'
      - '<gray>to your account.'
    commands:
      - 'fly addtime %player% 43200'
  fly_24h:
    name: '<white>24 Hours Fly Time'
    material: FEATHER
    price: 8000
    lore:
      - '<gray>Add 24 hours of flight time'
      - '<gray>to your account.'
    commands:
      - 'fly addtime %player% 86400'
  fly_1d:
    name: '<white>1 Day Fly Time'
    material: FEATHER
    price: 8000
    lore:
      - '<gray>Add 1 day of flight time'
      - '<gray>to your account.'
    commands:
      - 'fly addtime %player% 86400'
  fly_3d:
    name: '<white>3 Days Fly Time'
    material: FEATHER
    price: 22000
    lore:
      - '<gray>Add 3 days of flight time'
      - '<gray>to your account.'
    commands:
      - 'fly addtime %player% 259200'
  fly_5d:
    name: '<white>5 Days Fly Time'
    material: FEATHER
    price: 35000
    lore:
      - '<gray>Add 5 days of flight time'
      - '<gray>to your account.'
    commands:
      - 'fly addtime %player% 432000'
  fly_7d:
    name: '<white>7 Days Fly Time'
    material: FEATHER
    price: 48000
    lore:
      - '<gray>Add 7 days of flight time'
      - '<gray>to your account.'
    commands:
      - 'fly addtime %player% 604800'
  fly_unlimited:
    name: '<#FFD300><bold>Unlimited Fly Time'
    material: NETHER_STAR
    price: 150000
    lore:
      - '<gray>Unlock unlimited flight time'
      - '<gray>for your account.'
    commands:
      - 'fly settime %player% -1'

Key Options & Behavior Breakdown

Option / Key Path	Default Setting	Technical Functionality & Usage
`items`	`Object`	Root configuration section managing `items` subsystem.
`items.fly_1h`	`List/Object`	Adjusts `fly_1h` parameter for the `items` handler.
`items.fly_3h`	`List/Object`	Adjusts `fly_3h` parameter for the `items` handler.
`items.fly_12h`	`List/Object`	Adjusts `fly_12h` parameter for the `items` handler.
`items.fly_24h`	`List/Object`	Adjusts `fly_24h` parameter for the `items` handler.
`items.fly_1d`	`List/Object`	Adjusts `fly_1d` parameter for the `items` handler.
`items.fly_3d`	`List/Object`	Adjusts `fly_3d` parameter for the `items` handler.
`items.fly_5d`	`List/Object`	Adjusts `fly_5d` parameter for the `items` handler.
`items.fly_7d`	`List/Object`	Adjusts `fly_7d` parameter for the `items` handler.
`items.fly_unlimited`	`List/Object`	Adjusts `fly_unlimited` parameter for the `items` handler.

📄 `coinshop\godperks.yml`

Configuration file managing godperks.yml in BharatCore.

Full YAML Source (`coinshop\godperks.yml`)

items:
  god_1h:
    name: '<white>1 Hour God Mode Time'
    material: ENCHANTED_GOLDEN_APPLE
    price: 500
    lore:
      - '<gray>Add 1 hour of God Mode time'
      - '<gray>to your account.'
    commands:
      - 'godadmin add %player% 3600'
  god_3h:
    name: '<white>3 Hours God Mode Time'
    material: ENCHANTED_GOLDEN_APPLE
    price: 1200
    lore:
      - '<gray>Add 3 hours of God Mode time'
      - '<gray>to your account.'
    commands:
      - 'godadmin add %player% 10800'
  god_12h:
    name: '<white>12 Hours God Mode Time'
    material: ENCHANTED_GOLDEN_APPLE
    price: 4500
    lore:
      - '<gray>Add 12 hours of God Mode time'
      - '<gray>to your account.'
    commands:
      - 'godadmin add %player% 43200'
  god_24h:
    name: '<white>24 Hours God Mode Time'
    material: ENCHANTED_GOLDEN_APPLE
    price: 8000
    lore:
      - '<gray>Add 24 hours of God Mode time'
      - '<gray>to your account.'
    commands:
      - 'godadmin add %player% 86400'
  god_1d:
    name: '<white>1 Day God Mode Time'
    material: ENCHANTED_GOLDEN_APPLE
    price: 8000
    lore:
      - '<gray>Add 1 day of God Mode time'
      - '<gray>to your account.'
    commands:
      - 'godadmin add %player% 86400'
  god_3d:
    name: '<white>3 Days God Mode Time'
    material: ENCHANTED_GOLDEN_APPLE
    price: 22000
    lore:
      - '<gray>Add 3 days of God Mode time'
      - '<gray>to your account.'
    commands:
      - 'godadmin add %player% 259200'
  god_5d:
    name: '<white>5 Days God Mode Time'
    material: ENCHANTED_GOLDEN_APPLE
    price: 35000
    lore:
      - '<gray>Add 5 days of God Mode time'
      - '<gray>to your account.'
    commands:
      - 'godadmin add %player% 432000'
  god_7d:
    name: '<white>7 Days God Mode Time'
    material: ENCHANTED_GOLDEN_APPLE
    price: 48000
    lore:
      - '<gray>Add 7 days of God Mode time'
      - '<gray>to your account.'
    commands:
      - 'godadmin add %player% 604800'
  god_unlimited:
    name: '<#FFD300><bold>Unlimited God Mode Time'
    material: NETHER_STAR
    price: 150000
    lore:
      - '<gray>Unlock unlimited God Mode time'
      - '<gray>for your account.'
    commands:
      - 'godadmin set %player% -1'

Key Options & Behavior Breakdown

Option / Key Path	Default Setting	Technical Functionality & Usage
`items`	`Object`	Root configuration section managing `items` subsystem.
`items.god_1h`	`List/Object`	Adjusts `god_1h` parameter for the `items` handler.
`items.god_3h`	`List/Object`	Adjusts `god_3h` parameter for the `items` handler.
`items.god_12h`	`List/Object`	Adjusts `god_12h` parameter for the `items` handler.
`items.god_24h`	`List/Object`	Adjusts `god_24h` parameter for the `items` handler.
`items.god_1d`	`List/Object`	Adjusts `god_1d` parameter for the `items` handler.
`items.god_3d`	`List/Object`	Adjusts `god_3d` parameter for the `items` handler.
`items.god_5d`	`List/Object`	Adjusts `god_5d` parameter for the `items` handler.
`items.god_7d`	`List/Object`	Adjusts `god_7d` parameter for the `items` handler.
`items.god_unlimited`	`List/Object`	Adjusts `god_unlimited` parameter for the `items` handler.

📄 `coinshop\perks.yml`

Configuration file managing perks.yml in BharatCore.

Full YAML Source (`coinshop\perks.yml`)

title: "<dark_gray>Perks Selector - Page {page}/{max_page}"
size: 54

# The slots where perks will be dynamically populated.
perk-slots:
  - 10
  - 11
  - 12
  - 13
  - 14
  - 15
  - 16
  - 19
  - 20
  - 21
  - 22
  - 23
  - 24
  - 25
  - 28
  - 29
  - 30
  - 31
  - 32
  - 33
  - 34

filler:
  material: BLACK_STAINED_GLASS_PANE
  name: " "
  slots: [0,1,2,3,4,5,6,7,8,9, 17,18, 26,27, 35,36,37,38,39,40,41,42,43,44, 47,51,52,53]

toggle-button:
  slot: 46

next-page:
  slot: 50
  material: ARROW
  name: "<green>Next Page"

prev-page:
  slot: 48
  material: ARROW
  name: "<red>Previous Page"

close-button:
  slot: 49
  material: BARRIER
  name: "<red><bold>CLOSE"

# Global Lores injected at the bottom of the item dynamically
status-lores:
  unlocked:
    - ""
    - "<green>✔ <white>Unlocked"
    - "<yellow>► Click to use perk!"
  locked:
    - ""
    - "<red>✘ Locked"
    - "<#FFD300>₹ <white>Price: <#FFD300>{price} Coins"
    - "<gray>Click to purchase this perk!"

# ---------------------------------------------
# Perks definitions
# ---------------------------------------------
# price:          (integer) — coin cost in the coinshop.
# commands:       (list)    — commands executed upon purchase.
# click-commands: (list)    — commands executed when clicked while unlocked.
# permission:     override permission permission node (defaults to bharatcore.perks.<id>)
# ---------------------------------------------
perks:
  condense:
    name: "<#FE8924><bold>Condense Perk"
    material: HOPPER
    permission: "bharatcore.perks.condense"
    price: 828
    lore:
      - "<gray>Instantly compact raw items"
      - "<gray>into blocks using /condense."
    commands:
      - "[givepermission] bharatcore.perks.condense"
      - "[givepermission] essentials.condense"
    click-commands:
      - "[player] condense"
  nickname:
    name: "<#3CFE24><bold>Nickname Perk"
    material: NAME_TAG
    permission: "bharatcore.nick"
    price: 2388
    lore:
      - "<gray>Set a custom display name"
      - "<gray>using /nick."
    commands:
      - "[givepermission] bharatcore.nick"
      - "[givepermission] essentials.nick"
    click-commands:
      - "[player] nick"
  crawl:
    name: "<#FE24AE><bold>Crawl Perk"
    material: COBWEB
    permission: "GSit.Crawl"
    price: 348
    lore:
      - "<gray>Unlock the ability to crawl"
      - "<gray>on the ground with /crawl."
    commands:
      - "[givepermission] GSit.Crawl"
    click-commands:
      - "[player] crawl"
  bellyflop:
    name: "<#2AFF92><bold>BellyFlop Perk"
    material: WATER_BUCKET
    permission: "GSit.BellyFlop"
    price: 348
    lore:
      - "<gray>Perform a belly flop"
      - "<gray>using /bellyflop."
    commands:
      - "[givepermission] GSit.BellyFlop"
    click-commands:

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

      - "<gray>Repair the item in hand"
      - "<gray>using /repair."
    commands:
      - "[givepermission] bharatcore.perks.repair"
      - "[givepermission] essentials.repair"
    click-commands:
      - "[player] repair"
  godmode:
    name: "<#FFE100><bold>God Mode Perk"
    material: ENCHANTED_GOLDEN_APPLE
    permission: "bharatcore.perks.god"
    price: 3588
    lore:
      - "<gray>Toggle invincibility"
      - "<gray>using /god."
    commands:
      - "[givepermission] bharatcore.perks.god"
      - "[givepermission] essentials.god"
    click-commands:
      - "[player] god"
  flight:
    name: "<#00C8FF><bold>Flight Perk"
    material: FEATHER
    permission: "tempfly.use"
    price: 3588
    lore:
      - "<gray>Toggle flight ability"
      - "<gray>using /fly."
    commands:
      - "[givepermission] tempfly.use"
      - "[givepermission] tempfly.own"
      - "[givepermission] tempfly.others"
      - "[givepermission] tempfly.wilderness"
    click-commands:
      - "[player] fly"

Key Options & Behavior Breakdown

Option / Key Path	Default Setting	Technical Functionality & Usage
`title`	`"<dark_gray>Perks Selector - Page {page}/{max_page}"`	Root configuration section managing `title` subsystem.
`size`	`54`	Root configuration section managing `size` subsystem.
`perk-slots`	`Object`	Root configuration section managing `perk-slots` subsystem.
`filler`	`Object`	Root configuration section managing `filler` subsystem.
`filler.material`	`BLACK_STAINED_GLASS_PANE`	Adjusts `material` parameter for the `filler` handler.
`filler.name`	`" "`	Adjusts `name` parameter for the `filler` handler.
`filler.slots`	`[0,1,2,3,4,5,6,7,8,9, 17,18, 26,27, 35,36,37,38,39,40,41,42,43,44, 47,51,52,53]`	Adjusts `slots` parameter for the `filler` handler.
`toggle-button`	`Object`	Root configuration section managing `toggle-button` subsystem.
`toggle-button.slot`	`46`	Adjusts `slot` parameter for the `toggle-button` handler.
`next-page`	`Object`	Root configuration section managing `next-page` subsystem.
`next-page.slot`	`50`	Adjusts `slot` parameter for the `next-page` handler.
`next-page.material`	`ARROW`	Adjusts `material` parameter for the `next-page` handler.
`next-page.name`	`"<green>Next Page"`	Adjusts `name` parameter for the `next-page` handler.
`prev-page`	`Object`	Root configuration section managing `prev-page` subsystem.
`prev-page.slot`	`48`	Adjusts `slot` parameter for the `prev-page` handler.
`prev-page.material`	`ARROW`	Adjusts `material` parameter for the `prev-page` handler.
`prev-page.name`	`"<red>Previous Page"`	Adjusts `name` parameter for the `prev-page` handler.
`close-button`	`Object`	Root configuration section managing `close-button` subsystem.
`close-button.slot`	`49`	Adjusts `slot` parameter for the `close-button` handler.
`close-button.material`	`BARRIER`	Adjusts `material` parameter for the `close-button` handler.
`close-button.name`	`"<red><bold>CLOSE"`	Adjusts `name` parameter for the `close-button` handler.
`status-lores`	`Object`	Root configuration section managing `status-lores` subsystem.
`status-lores.unlocked`	`List/Object`	Adjusts `unlocked` parameter for the `status-lores` handler.
`status-lores.locked`	`List/Object`	Adjusts `locked` parameter for the `status-lores` handler.
`perks`	`Object`	Root configuration section managing `perks` subsystem.
`perks.condense`	`List/Object`	Adjusts `condense` parameter for the `perks` handler.
`perks.nickname`	`List/Object`	Adjusts `nickname` parameter for the `perks` handler.
`perks.crawl`	`List/Object`	Adjusts `crawl` parameter for the `perks` handler.
`perks.bellyflop`	`List/Object`	Adjusts `bellyflop` parameter for the `perks` handler.
`perks.hat`	`List/Object`	Adjusts `hat` parameter for the `perks` handler.
`perks.sit`	`List/Object`	Adjusts `sit` parameter for the `perks` handler.
`perks.lay`	`List/Object`	Adjusts `lay` parameter for the `perks` handler.
`perks.feed`	`List/Object`	Adjusts `feed` parameter for the `perks` handler.
`perks.heal`	`List/Object`	Adjusts `heal` parameter for the `perks` handler.
`perks.extinguish`	`List/Object`	Adjusts `extinguish` parameter for the `perks` handler.
`perks.near_perk`	`List/Object`	Adjusts `near_perk` parameter for the `perks` handler.
`perks.disposal`	`List/Object`	Adjusts `disposal` parameter for the `perks` handler.
`perks.top`	`List/Object`	Adjusts `top` parameter for the `perks` handler.
`perks.skull`	`List/Object`	Adjusts `skull` parameter for the `perks` handler.
`perks.craft_table`	`List/Object`	Adjusts `craft_table` parameter for the `perks` handler.
`perks.enderchest`	`List/Object`	Adjusts `enderchest` parameter for the `perks` handler.
`perks.anvil`	`List/Object`	Adjusts `anvil` parameter for the `perks` handler.
`perks.repair`	`List/Object`	Adjusts `repair` parameter for the `perks` handler.
`perks.godmode`	`List/Object`	Adjusts `godmode` parameter for the `perks` handler.
`perks.flight`	`List/Object`	Adjusts `flight` parameter for the `perks` handler.

Shop Architecture & Submodules​

In-Game Dynamic Editor​

Currency Transaction Engine​

title: "BharatCore: Coin Shop & Cosmetic Perks" description: "Exhaustive YAML configurations with verbatim syntax and detailed option breakdowns."​

📄 coinshop\coinshop.yml​

Full YAML Source (coinshop\coinshop.yml)​

Key Options & Behavior Breakdown​

📄 coinshop\chatcolor.yml​

Full YAML Source (coinshop\chatcolor.yml)​

Key Options & Behavior Breakdown​

📄 coinshop\namecolor.yml​

Full YAML Source (coinshop\namecolor.yml)​

Key Options & Behavior Breakdown​

📄 coinshop\tags.yml​

Full YAML Source (coinshop\tags.yml)​

Key Options & Behavior Breakdown​

📄 coinshop\glow.yml​

Full YAML Source (coinshop\glow.yml)​

Key Options & Behavior Breakdown​

📄 coinshop\flyperks.yml​

Full YAML Source (coinshop\flyperks.yml)​

Key Options & Behavior Breakdown​

📄 coinshop\godperks.yml​

Full YAML Source (coinshop\godperks.yml)​

Key Options & Behavior Breakdown​

📄 coinshop\perks.yml​

Full YAML Source (coinshop\perks.yml)​

Key Options & Behavior Breakdown​

Shop Architecture & Submodules

In-Game Dynamic Editor

Currency Transaction Engine

title: "BharatCore: Coin Shop & Cosmetic Perks" description: "Exhaustive YAML configurations with verbatim syntax and detailed option breakdowns."

📄 `coinshop\coinshop.yml`

Full YAML Source (`coinshop\coinshop.yml`)

Key Options & Behavior Breakdown

📄 `coinshop\chatcolor.yml`

Full YAML Source (`coinshop\chatcolor.yml`)

Key Options & Behavior Breakdown

📄 `coinshop\namecolor.yml`

Full YAML Source (`coinshop\namecolor.yml`)

Key Options & Behavior Breakdown

📄 `coinshop\tags.yml`

Full YAML Source (`coinshop\tags.yml`)

Key Options & Behavior Breakdown

📄 `coinshop\glow.yml`

Full YAML Source (`coinshop\glow.yml`)

Key Options & Behavior Breakdown

📄 `coinshop\flyperks.yml`

Full YAML Source (`coinshop\flyperks.yml`)

Key Options & Behavior Breakdown

📄 `coinshop\godperks.yml`

Full YAML Source (`coinshop\godperks.yml`)

Key Options & Behavior Breakdown

📄 `coinshop\perks.yml`

Full YAML Source (`coinshop\perks.yml`)

Key Options & Behavior Breakdown