ChristmasPlugin: A Festive Adventure for Minecraft
Transform your Minecraft server into a festive wonderland with
Christmas Plugin! This plugin offers an engaging shard-based economy, daily gifts, festive music, and interactive events like Santa's arrival. Below, you'll find detailed explanations and examples for all features.
Features and YAML Examples
1. Shard Economy
Shards are a special in-game currency that players can earn through activities like mining blocks and defeating mobs. They can be spent in the Shard Shop on rewards.
Earning Shards
Players can earn shards by performing specific tasks, such as mining blocks or killing mobs. The YAML configuration allows you to customize the type of activity, the reward (shards), and the probability of earning them.
Mining Blocks Example:
Code (YAML):
blocks:
diamond_ore:
shards
: 16
chance
: 0.2
# 20% chance of earning 16 shards per block
gold_ore:
shards
: 10
chance
: 0.1
# 10% chance of earning 10 shards per block
coal_ore:
shards
: 2
chance
: 0.5
# 50% chance of earning 2 shards per block
- blocks: Defines the block types eligible for shard rewards.
- shards: The number of shards awarded for mining the block.
- chance: The probability (0.0–1.0) of earning the shards upon breaking the block.
Killing Mobs Example:
Code (YAML):
[code]mobs:
zombie:
shards
: 5
chance
: 0.3
# 30% chance to earn shards
skeleton:
shards
: 3
chance
: 0.5
# 50% chance to earn shards
creeper:
shards
: 2
chance
: 0.2
# 20% chance to earn shards
- mobs: Lists mobs eligible for shard rewards.
- shards: The number of shards earned for killing the mob.
- chance: Probability of earning shards.
Spending Shards in the Shard Shop
The Shard Shop is where players spend shards on rewards. Items are displayed with custom names, icons, and commands for more control over what players can buy.
Shard Shop Example:
Code (YAML):
items:
item1:
slot
: 31
# Position in the GUI
icon
:
"PAPER"
display_name
:
"&c&l1 Skill Point"
lore
:
-
"&c&lPrice:"
-
"&f- 400 Shards"
custom_model_data
: 10394
# Visual customization for the item
price
: 400
commands
:
-
"mmocore admin skill-points give %player% 1"
item2:
slot
: 13
icon
:
"PLAYER_HEAD"
head_texture
:
"eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh..."
display_name
:
"&5&l1 Class Point"
lore
:
-
"&5&lPrice:"
-
"&f- 1000 Shards"
custom_model_data
: 10395
price
: 1000
commands
:
-
"mmocore admin class-points give %player% 1"
- items: Defines the purchasable items.
- slot: Position of the item in the GUI.
- icon: Item icon used in the shop.
- display_name: Name displayed in the GUI.
- lore: Additional description.
- custom_model_data: Optional model customization.
- price: Cost in shards.
- commands: Executed commands upon purchase.
2. Daily Gifts
Daily gifts allow players to receive rewards based on their group. Gifts can be fully customized with items, messages, events, and probabilities.
Default Group Example
This example gives basic rewards like diamonds or emeralds to players in the default group.
Code (YAML):
# Daily gifts configuration
daily-gifts:
item:
material
: PLAYER_HEAD
head_texture
:
"eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMzUyMDgyZTY2ZjRkOTU0NjQ1MGUxYmI3ZGVlNGE2MzNhZmZiMjdiNDkwNzAxNGM0NGE0NjgxOGMxZGVlZWU5ZiJ9fX0="
display_name
:
"&6Daily gift"
lore
:
-
"&7Right click with this item to redeem!"
rewards:
default:
gift1:
commands
:
- give
%player% minecraft:diamond 1
messages
:
-
"&6You've received a diamond!"
chance
: 2
event:
firework
: true
sound
: ENTITY_PLAYER_LEVELUP
gift2:
commands
:
- give
%player% minecraft:emerald 5
messages
:
-
"Here are some Christmas emeralds!"
chance
: 5
event:
firework
: false
sound
: ENTITY_VILLAGER_CELEBRATE
vip:
gift1:
commands
:
- give
%player% minecraft:diamond 5
messages
:
-
"&6You've received diamonds!"
chance
: 2
event:
firework
: true
sound
: ENTITY_PLAYER_LEVELUP
gift2:
commands
:
- give
%player% minecraft:netherite_ingot 1
messages
:
-
"Here is a Christmas netherite!"
chance
: 5
event:
firework
: false
sound
: ENTITY_VILLAGER_CELEBRATE
- commands: Commands executed to give the reward.
- messages: Messages sent to the player.
- chance: Probability of receiving this gift.
- event: Adds effects like fireworks or sounds.
VIP Group Example
VIP players receive premium rewards like multiple diamonds or netherite ingots.
Code (YAML):
rewards:
vip:
gift1:
commands
:
- give
%player% minecraft:diamond 5
messages
:
-
"&6You've received diamonds!"
chance
: 2
# 2% chance of receiving this gift
event:
firework
: true
sound
: ENTITY_PLAYER_LEVELUP
gift2:
commands
:
- give
%player% minecraft:netherite_ingot 1
messages
:
-
"Here is a Christmas netherite!"
chance
: 5
# 5% chance of receiving this gift
event:
firework
: false
sound
: ENTITY_VILLAGER_CELEBRATE
3. Play Festive Music
Using
NoteBlockAPI, you can play festive .nbs music files in-game.
Music Configuration Example
Code (YAML):
tracks:
12days:
file
:
"12 days.nbs"
display_name
:
"&a12 Days of Christmas!"
carol:
file
:
"carol_of_the_bells.nbs"
display_name
:
"&bCarol of the Bells"
frosty:
file
:
"frosty_the_snowman.nbs"
display_name
:
"&dFrosty the Snowman!"
- tracks: Defines the available music tracks.
- file: Path to the .nbs file.
- display_name: Name shown for the track.
4. Santa Claus Event
Santa is a special event entity that spawns periodically and rewards players with themed gifts.
Santa Spawn Configuration
Code (YAML):
skin
:
"brcdev"
enabled
: true
spawn:
spawn-message
:
"&aSanta spawned at %location%"
leave-message
:
"&aSanta left from %location%"
cooldown
: 3600
stay_time
: 600
random
: true
regions
:
region1:
world
:
"ressource"
# your world name
region
:
"santa"
#your worlguard region name
displayname
:
"&cSanta1"
# the name you wish to give to santa
location:
x
: 73.325
y
: 132.00
z
: -66.396
region2:
world
:
"ressource"
region
:
"santa2"
displayname
:
"&cSanta2"
location:
x
: 64.079
y
: 132.00
z
: -67.176
gifts:
delay
: 5
item:
material
: PLAYER_HEAD
head_texture
:
"eyJ0ZXh0dXJlcyI6eyJTS0lOIjp7InVybCI6Imh0dHA6Ly90ZXh0dXJlcy5taW5lY3JhZnQubmV0L3RleHR1cmUvMzUyMDgyZTY2ZjRkOTU0NjQ1MGUxYmI3ZGVlNGE2MzNhZmZiMjdiNDkwNzAxNGM0NGE0NjgxOGMxZGVlZWU5ZiJ9fX0="
display_name
:
"&6Santa gift"
lore
:
-
"&7Right click with this item to redeem!"
rewards:
gift1:
commands
:
- give
%player% minecraft:diamond 1
messages
:
-
"&6You've received a diamond!"
chance
: 2
event:
firework
: true
sound
: ENTITY_PLAYER_LEVELUP
gift2:
commands
:
- give
%player% minecraft:emerald 5
messages
:
-
"Here are some Christmas emeralds!"
chance
: 5
event:
firework
: false
sound
: ENTITY_VILLAGER_CELEBRATE
5. Interactive Events
Villager Snowball Event
Players can throw snowballs at villagers for rewards.
Code (YAML):
villager-shoot:
rewards:
default:
cooldown
: 30
# 30-second cooldown between rewards
reward1:
chance
: 2
commands
:
- give
%player% minecraft:cookie 1
messages
:
-
"&6You got a cookie for spreading Christmas spirit!"
event:
firework
: false
sound
: ENTITY_EXPERIENCE_ORB_PICKUP
HARD-DEPENDENCIES / SOFTDEPENDENCIES :
- Libdisguise
- NoteBlockAPI
- Luckperms
Enjoy spreading festive cheer with
ChristmasPlugin and make your server unforgettable this holiday season!
### **6. Coming Soon**
Stay tuned for even more exciting features in future updates. Make your server the ultimate Christmas destination!