🛍️ The Shard Shop

A SmartInvs GUI where players spend shards. Items can give direct rewards or run console commands.

🧱 How it works

1. Players run /shards or /shards shop.
2. GUI shows configured items (icon, price, description).
3. On click → confirmation GUI → if confirmed and balance ≥ price:
   • Shards deducted.
   • Either console commands run, or a direct item is granted.

All entries are defined in shardshop.yml.

💰 Reward modes

1) Command-based reward

diamond_item:
  icon: DIAMOND
  slot: 10
  price: 100
  display_name: "&b&lShiny Diamond"
  lore:
    - "&7A classic Christmas treasure!"
    - "&cLimited stock!"
  commands:
    - "give %player% diamond 1"

2) Direct item reward

sword_of_light:
  icon: GOLDEN_SWORD
  slot: 12
  price: 500
  display_name: "&e&lSword of Light"
  lore:
    - "&7Forged in Santa's forge."
    - "&6+ Custom Damage"
    - "&6+ Attack Speed"
  attackdamage: 10
  attackspeed: 8
  max_durability: 42
  custom_model_data: 100

3) More examples

santa_hat:
  icon: LEATHER_HELMET
  slot: 28
  price: 150
  display_name: "&c&lSanta Hat"
  lore:
    - "&7Wear with pride!"
    - "&fLimited Event Cosmetic"
  max_durability: 200
  custom_model_data: 303

diamond_stack:
  icon: DIAMOND
  slot: 30
  price: 800
  display_name: "&b&lPouch of Diamonds"
  lore:
    - "&7Contains &b16x Diamonds&7."
  commands:
    - "give %player% diamond 16"

🛒 Player experience

Polished GUI with confirm step, hover text, and feedback sounds.

⚖️ Balancing

• Encourage playtime → lower prices, frequent small rewards.
• Create exclusivity → higher prices, rare shard sources.
• Add excitement → custom items, limited durability.
• Prevent inflation → daily income < ~⅓ of avg item cost.

🔧 Dev tips

• Slots use 0–53 in a 6×9 GUI.
• Reorder via slot—any config order is fine.
• Commands always run as console; %player% works everywhere.

🧠 Weekly rotation idea

• W1: Coal Bundle (50) — gag reward
• W2: Santa Hat (150) — cosmetic
• W3: Sword of Light (500) — combat
• W4: Santa’s Wrath Axe (750) — late event