❄ WHAT IS THIS PLUGIN?
This is not “just cosmetics.”
This is a full event system for your server:

• Shard Economy – custom Christmas currency players grind and spend in a GUI shop
• Interactive Santa NPC – walks around, gives gifts, talks, and announces when he arrives
• Daily Gifts System – per-group configurable rewards (perfect for donor ranks / VIPs)
• Festive Music – play .nbs holiday songs server-wide with a clean selector
• Snowball Villager Event – throw snowballs at villagers for loot and sounds
• Shard Shop GUI – sell custom stat items, console commands, cosmetics, boosters, etc.
• ItemsAdder / MythicMobs / ModelEngine Hooks – works with your custom content
• LuckPerms Group Support – VIPs get better gifts automatically
• Fully Compatible with OreoEssentials!

Why it works:

• Player retention – daily rewards + random Santa events
• Donations – VIP / rank-exclusive loot tables
• Hype – “SANTA IS IN SPAWN RIGHT NOW, GET HERE!!!”
• Christmas vibes – lights, gifts, themed weapons, music

It literally turns December into content. Players will log in every day so they don’t miss rewards.

ery day to not miss rewards.



MAIN FEATURES

1. SHARD ECONOMY

Players earn Shards (your special Christmas currency) by doing normal gameplay:
mining ores, chopping trees, killing mobs, custom MythicMobs bosses, etc.

You control:
-> How many shards they get
-> The % drop chance
-> Support for vanilla mobs/blocks
-> Support for ItemsAdder blocks
-> Support for MythicMobs mobs

Example config:
So if you already run a survival or RPG server → you don’t have to change your gameplay.
Christmas rewards just “appear” on top of what players are already doing.
Less work for you. More grind for them. They LOVE that.

2. SHARD SHOP GUI ( /shards shop )

Players spend their shards in a 6x9 GUI store.
Click an item → they get a confirmation menu → buy → done.

You can make the shop:

• Give direct custom items with stats, lore, durability, glowing effect
  
  
• OR run console commands (skills, permissions, crate keys, etc.)

Basically: you can sell anything.

Config example:
Highlights buyers will like:

• attackdamage / attackspeed → adds real AttributeModifiers to the item.
  
  
• max_durability → item shows “Durability: 42 uses left” in lore.
  
  
• Items glow (fake Unbreaking, flags hidden) → looks rare, players WANT them.
  
  
• You can literally sell P2W gear (if your server allows it) without extra plugins.

3. Fight the Grinch BOSS ! HE IS GOING TO RUIN CHRISTMAS !



Grinchboss.yml:

Code (YAML):

enabled : true

display_name : "&2&lThe Grinch"
# Must be a valid Mojang username with a public skin
skin : "L1lius"

stats:
  health : 800
  speed : 0.32

cosmetics:
  glowing : true
  thunder : true

# AI pacing
ai:
  tick_rate : 20                 # internal loop tick rate
  taunt_every_seconds : 25
  ability_every_seconds : 12

messages:
  spawn_lines :
   - "&2The Grinch:&7 Ho ho—no. &cNo Christmas this year!"
    - "&2The Grinch:&7 I’ll turn your joy into &2silence&7."
  taunts :
   - "&2The Grinch:&7 Your cheer makes me sick!"
    - "&2The Grinch:&7 I’ll stuff your stockings with sorrow!"
  death_lines :
   - "&aThe Grinch retreats into the blizzard… for now."

# Weighted abilities (higher = more often)
abilities:
  roar_knockback:
    weight : 20
  snowstorm_slow:
    weight : 30
  shadow_dash:
    weight : 25
  summon_minions:
    weight : 25

# Rewarding after death
rewarding:
  top_contributors : 5             # reward top N damage dealers

# Weighted reward buckets; each winner gets one bucket
rewards:
  shards_big:
    chance : 40
    commands :
     - "shards give %player% 150"
    messages :
     - "&a+150 shards from the Grinch’s stolen stash!"
  diamonds:
    chance : 30
    commands :
     - "give %player% diamond 6"
    messages :
     - "&bSix frosty diamonds glitter in your hand."
  mythic_key:
    chance : 20
    commands :
     - "crate key give %player% Mythic 1"
    messages :
     - "&dYou received a &lMythic Key&d!"
  rare_title:
    chance : 10
    commands :
     - "lp user %player% parent addtemp grinchslayer 7d"
    messages:
      - "&6Title unlocked : &eGrinch Slayer &7 (7d ) "

# Chest dropped at the death location (filled with Santa presents + optional extras)
loot_chest:
  enabled: true
  min_gifts: 3
  max_gifts: 6
  announce: "&aA loot chest appeared at &f %x%,%y%,%z%&a!"
  extra_items:
    coal:
      material : "COAL"
      amount : 8
    gold_nuggets:
      material : "GOLD_NUGGET"
      amount : 16
 

4. DAILY GIFTS SYSTEM

Every day, players can claim a “daily gift.”
You can define different loot tables per rank (default, VIP, legend, etc.), so donors get better stuff.

That means: this plugin is also a monetization tool.

Example:
Each “giftX” entry is weighted with chance.
You can make super rare rewards (1% chance netherite) and players will log in daily to try their luck.

4. SANTA CLAUS NPC (EVENT BOSS BUT WHOLESOME)

Santa is a REAL NPC that appears in your world, walks around, gives presents, and then leaves.

The plugin:

• Spawns him automatically on a timer
  
  
• Announces to the whole server when he appears (“Santa has spawned at X,Y,Z!!!”)
  
  
• Lets players RIGHT-CLICK him to get randomized gifts
  
  
• Auto-despawns him after stay_time
  
  
• Supports LibsDisguises skin, WorldGuard region, etc.

You can fully theme him per world / hub / city.

Why players will scream in chat:

• “SANTA IS AT SPAWN!!”
  
  
• “CLICK HIM FAST!!”
  
  
• “HE GAVE ME 25 SHARDS OMG”
  This is pure dopamine. It creates instant crowd moments on your server.

5. FESTIVE MUSIC SYSTEM

Play .nbs files (NoteBlockAPI) across the server or per-player.
Perfect for hub servers, spawn areas, Christmas lobbies.

You can rename, add/remove songs, change display names in GUI, etc.
Imagine: players join your hub and it’s literally playing Carol of the Bells. Instant mood.

6. SNOWBALL VILLAGER EVENT

A goofy / wholesome minigame:

• Players throw snowballs at a “target villager.”
  
  
• They can win cookies, rewards, sounds, fireworks, etc.
  
  
• Has a cooldown per player so it doesn’t get abused.

This is perfect for spawn / lobby areas to keep people busy and laughing.


DEPENDENCIES / INTEGRATIONS
->LuckPerms (used for group-based gift tables like default/vip/etc.)
->NoteBlockAPI (for music)
->LibsDisguises (for Santa skin)

OPTIONAL:
ItemsAdder (optional, for custom block shard drops
MythicMobs / ModelEngine (optional, shard rewards from bosses)


You do NOT need ItemsAdder or MythicMobs to use the plugin. They’re soft hooks.
Vanilla servers work fine.

[HR][/HR]

WHY YOUR SERVER NEEDS THIS LIKE… NOW
+ player retention
+ server hype
+ donator value
+ content for staff to announce on Discord every day

This is a Christmas / New Year EVENT PACK in 1 plugin

Buy it once → run it every December as your seasonal event.
Your community will start expecting it every year.
That’s how you build tradition.
[/center]