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
| Key | Meaning |
|---|---|
price | Cost in shards. |
money | Cost in server currency instead — needs Vault plus an economy plugin. |
stock-per-day | How many times one player may buy this per day (e.g. a limited mystery-gift roll). |
requires-nice | Minimum 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
- Mystery Gift — costs 250, pays out
shards: 50-400, limited tostock-per-day: 3. A daily gamble. - Nice List Pass —
requires-nice: -50andnaughty-nice: 25: lets naughty players buy their way back up the list. - Dyed gear — leather items take a
colourhex, so a proper red Santa hat is one line. - Selling crate keys, permissions or skill points is just a
commandsentry.