UltimateChristmas 4.0 Wiki

UltimateChristmas / Shard shop

Shard shop — Santa's Workshop

A tabbed GUI store where players spend their shards. Entries are ordinary rewards with a price attached, so anything the advent calendar or a boss can hand out can also be sold here.

module id: shop config: modules/shop.yml

How players use it

/christmas shop (permission ultimatechristmas.shop) opens the store. Categories appear as tabs along the bottom; clicking an item shows a yes/no confirmation before payment is taken (confirm-purchases: true).

General settings

menu:
  # %category% and %balance% are available.
  title: "&6&l❄ Santa's Workshop &7- %category%"

confirm-purchases: true
open-permission: ultimatechristmas.shop

Categories and items

Each category becomes a tab, with a name and an icon. Each item is a reward plus pricing:

categories:
  treats:
    name: "&aTreats"
    icon: COOKIE
    items:
      cookie_bundle:
        material: COOKIE                 # the icon shown in the shop
        name: "&6Cookie Bundle"
        lore: ["&7A dozen fresh cookies."]
        price: 50                        # price in shards
        items:
          - { material: COOKIE, amount: 12 }

  gear:
    name: "&bGear"
    icon: DIAMOND_CHESTPLATE
    items:
      peppermint_blade:
        material: IRON_SWORD
        name: "&f&lPeppermint Blade"
        lore: ["&7Forged in Santa's workshop.", "&6+ Sharpness III"]
        price: 600
        items:
          - { material: IRON_SWORD, name: "&f&lPeppermint Blade",
              enchants: { sharpness: 3 }, glow: true }

Pricing keys

KeyMeaning
priceCost in shards.
moneyCost in server currency instead — needs Vault plus an economy plugin.
stock-per-dayHow many times one player may buy this per day (e.g. a limited mystery-gift roll).
requires-niceMinimum naughty/nice standing required to buy.

Beyond pricing, an entry takes every reward key: items, commands, effects, shards (yes — an entry can pay shards back out, like a mystery roll), naughty-nice, messages, firework and the rest.

Ideas from the default config