Santa Says | The Ultimate Christmas Minigame [1.20 - 1.21]

Santa Says | The Ultimate Christmas Minigame [1.20 - 1.21] -----

A fully automated, multi-arena "Simon Says" style minigame with a festive twist.

Minimum Java Version: Java 21

SANTA SAYS

Santa Says is a fast-paced Minecraft minigame built around quick challenges, competitive scoring, and round-based gameplay.

Players must complete a series of short tasks under time pressure, earning points through participation and top placements. After 15 intense rounds, the player with the highest score wins the game.

GAMEPLAY SHOWCASE

Watch the chaos unfold as Santa commands the game!

[IMG]

✨ FEATURES ✨

15 Rounds of Chaos: Every match consists of 15 randomly selected tasks from a huge pool.
44 Unique Tasks: A mix of "Participation" (everyone wins) and "Placement" (race to win) tasks.
Stunning Visuals: Powered by MiniMessage! Use Gradients, Hex Colors, and Sprites (custom images) in Chat, BossBars, ActionBars, Titles, and Scoreboards to create a modern look.
Advanced Placeholders: Full PlaceholderAPI support! Display live arena stats, player records, and Custom Leaderboards of any size (Top-3, Top-100, or more) on your holograms or lobbies.
Developer API: Built for extension! A clean, well-documented API allowing developers to easily hook into events, manipulate game states, and create custom add-ons.
️ Fail-Safe Smart Recovery: Server crash? Power outage? No problem. The arena tracks every single block change and entity spawn, restoring itself to a pristine state instantly upon restart. Zero lag, zero leftovers.
Cross-Server Sync: MySQL support to sync player statistics (wins, streaks, score) across your entire network.
NoteBlock Music: Includes festive tunes like "The Entertainer" integrated via NoteBlockAPI.
⚙️ Fully Configurable: Customize messages, task logic, items, and rewards via YAML.

THE TASKS (44 TOTAL)

Santa Says features 44 unique minigames split into two categories.

Participation Tasks
Everyone who completes the task gets +1 Point.

Enter the portal: Jump into the chosen portal, NOT the other portal.
Extinguish yourself: Place water under yourself.
Get into a minecart: Get in an available minecart.
Jump into the air on the spot: Jump while standing still. Do not move.
Jump into the water safely without hitting solid blocks: Jump into the water blocks and not the diamond blocks.
Look at a [block] block: Look at the specified block.
Look at a player's head: Look at another player's head.
Look at the sky: Look directly upwards.
Nod by looking up and down: Repeatedly look all the way up and all the way down.
Play a song with the noteblocks: Continuously click on a noteblock (right click).
Press the [material] button: Press one of the buttons of the specified material.
Remove the poison effect: Drink milk.
Slap a player with [item]: Hit another player while holding the specified item.
Spin around in a full circle: Turn your player head.
Stand completely still: Don't move (sneaking and moving your head is okay).
Stand on the snow: Stand on the snow, NOT the ice.
Throw a diamond at a player: Drop a diamond while facing another player.
Throw snowballs at other players: Throw snowballs while facing another player.

Placement Tasks
Race against time! 1st: 3pts, 2nd: 2pts, 3rd: 1pt.

Add [enchant] to a [material] sword: Use an anvil to add the specified enchantment onto the specified sword.
Break a [block] block: Use your tools to break the specified block.
Break the most snow: Break as much snow as possible.
Build an Iron Golem : Build a T-shape out of the 4 iron blocks and place the pumpkin on top.
Cure the zombie villager: Right click the zombie villager with the potion of weakness, then the golden apple.
Eat mushroom stew: Click on the mooshroom with the bowl and eat the resulting mushroom stew.
Eat until you're full: Eat items that give you the most hunger points to fill your hunger bar.
Fully equip [material] armor: Equip all pieces of the specified armor.
Get yourself to full health: Use the items given to regenerate and heal.
Give Santa milk and cookies: Right click on Santa with milk and cookies (any order).
Grow a tree: Place the sapling on the dirt, then continuously click it with the bonemeal.
Insert a music disc into the jukebox: Click on the jukebox with the music disc, NOT the other items.
Jump down the chimney: Climb the brick chimney using the ladders and fall down the hole.
Jump off the platform: Jump off the platform.
Jump up using a potion of leaping: Drink the jump boost potion, then jump on the diamond platform.
Keep punching the dragon egg : Continuously find and click the dragon egg.
Kill a(n) [animal]:Use your sword to kill the specified animal.
Make your inventory completely full: Use the given stack of items to completely fill your inventory.
Place a beacon on top of the pyramid: Place the beacon on top of the block pyramid.
Punch the most tall grass: Break as much tall grass as possible.
Put [item] on the armor stand: Click the armor stand while holding the specified item.
Remove the coal from inventory: Remove either 2 or 3 pieces of coal from your inventory.
Ride a pig off the platform: Guide your pig off of the platform using your carrot on a stick.
Shear the sheep: Use your shears to shear as many sheep as fast as you can.
Shoot yourself with an arrow: Look directly upwards, then shoot your bow and hit yourself.
Tame the horse: Use food items to tame the horse.

️ ARENA SETUP GUIDE

Setting up an arena is intuitive with our in-game GUI editor. Follow these steps:

Step 1: Create the Arena
Initialize a new arena with a unique ID.
[IMG]

Code (Text):

/ss create <arenaName>

Step 2: Open Setup Menu
Enter the Edit Mode to access the configuration GUI.
[IMG]

Code (Text):

/ss edit <arenaName>

Step 3: Set Locations
Click the Map Icon to set teleport points.
[IMG]

Lobby: Where players wait before the game.
Start: Where players spawn when the game begins.
End: Where players go after the game finishes.

Step 4: Define the Game Platform
Use the Blaze Rod to select the playable floor area.

Click here to see the GIF

Wand Controls:

Left Click: Add a rectangular area.
Right Click: Remove a rectangular area.
Shift + Left: Add a single block.
Middle Click: Toggle Particle Visualizer (See boundaries).
Drop (Q): CLEAR ALL platform data (Reset).

Step 5: Create a Game Sign (Optional)
Place a sign, look at it, and click the Sign item in the menu.
[IMG]

Step 6: Register & Join
Click the Firework item to save and activate the arena!
[IMG]

How to Join:

Command:

Code (Text):

/ss join <arenaName>

COMMANDS & PERMISSIONS

All commands can be used via /santasays or /ss.

Gameplay Commands
No permissions required by default.

/ss join <arena>

Join a specific arena lobby to wait for the next game. Checks for availability automatically.
/ss leave

Safely quit the current game and teleport back to the main lobby.
/ss stats [player]

View detailed statistics (wins, play time, etc.) via an in-game menu.

Supports viewing offline players as well.

Main Management Commands
Requires santasays.admin.* for full access.

/ss create <id>

Permission: santasays.arena.create

Initialize a new arena instance.
/ss delete <id>

Permission: santasays.arena.delete

Permanently delete an existing arena.
/ss edit <id>

Permission: santasays.arena.edit

Opens the in-game GUI editor for arena setup.
/ss list

Permission: santasays.arena.list

Displays a list of all registered arenas and their states.
/ss start <arena>

Permission: santasays.admin.start

Force start a match immediately, bypassing the countdown. Can be used remotely.
/ss stop <arena>

Permission: santasays.admin.stop

Immediately terminate an ongoing match. Matches stopped this way are cancelled (stats not saved).
/ss reload

Permission: santasays.admin.reload

Reloads messages, config, items, and scoreboards without restarting the server.
/ss help

Permission: santasays.admin.help

Displays a comprehensive list of available commands and their usage instructions.

Advanced Troubleshooting
Requires santasays.debug.* for full access.

⚠️ Note: You must enable debug: true in config.yml to use these commands.

/ss debug join <arena> [flags]

Permission: santasays.debug.join

Instantly start a game simulation with specific players and tasks.

Flags:

Code (Text):

--players=p1,p2

Code (Text):

--tasks=1-3,5,8,40-43
/ss debug tasks [page]

Permission: santasays.debug.tasks

Opens an interactive chat menu to view and force-start any task immediately.
/ss debug timer <arena> <time>

Permission: santasays.debug.timer

Manually set the remaining time for the current round or lobby.
/ss debug state <arena> <state>

Permission: santasays.debug.state

Force the arena into a specific state (WAITING, STARTING, IN_GAME, ENDING).
/ss debug next <tasks>

Permission: santasays.debug.next

Queue specific tasks to run next. Supports ranges (e.g., 1-5 8 10).
/ss debug round <number>

Permission: santasays.debug.round

Manually set the current round number.
/ss debug maxround <number>

Permission: santasays.debug.maxround

Set the maximum round number.
/ss debug component <text>

Permission: santasays.debug.component

Preview MiniMessage formats, gradients, and hex colors in-game.
/ss debug dump

Permission: santasays.debug.dump

Generates a performance timings report for event listeners.

PLACEHOLDERS

To use these placeholders, you must have PlaceholderAPI installed on your server.

Individual Player Stats
These placeholders display statistics for the player viewing them.

Code (Text):

%santasays_name% - Returns the player's name
%santasays_uuid% - Returns the player's unique ID
%santasays_win% - Total number of games won
%santasays_win_streak% - Current win streak
%santasays_win_streak_record% - Highest win streak ever reached
%santasays_lose% - Total number of games lost
%santasays_games_played% - Total games participated in
%santasays_rounds_played% - Total rounds survived or played

Real-Time Arena Data
Fetch live data from specific arenas. Replace <id> with your arena identifier (e.g., winter-arena).

Live Game Data

Code (Text):

%santasays_arena:<id>:players% - Current player count
%santasays_arena:<id>:round% - Current round number
%santasays_arena:<id>:state% - Game state (WAITING, IN_GAME)
%santasays_arena:<id>:timer% - Remaining seconds
%santasays_arena:<id>:formatted_timer% - Timer formatted as MM:SS

Arena Settings

Code (Text):

%santasays_arena:min_players:<id>% - Min required players
%santasays_arena:max_players:<id>% - Max allowed players

Leaderboard System
Display your server's top-performing players on scoreboards or holograms.

Syntax

Code (Text):

%santasays_leaderboard:<statistic>:<position>:<type>%

1. Parameters

<statistic>: The stat to be ranked (see list below).
<position>: The rank position (1, 2, 3...).
<type>:

Code (Text):

name

(username) or

Code (Text):

value

(score).

2. Available Statistics
You can use these stats for ranking:

win (Total wins)
lose (Total losses)
win_streak (Current streak)
win_streak_record (Best streak)
score_record (Highest score in a single game)
games_played (Total games joined)
rounds_played (Total rounds survived)

3. Usage Examples

Code (Text):

# Name of the 1st place winner (Most Wins)
%santasays_leaderboard:win:1:name%

# Score of the 1st place winner
%santasays_leaderboard:win:1:value%

# Name of the 3rd place for Win Streaks
%santasays_leaderboard:win_streak_record:3:name%

# Name of the 5th most active player
%santasays_leaderboard:games_played:5:name%

TERMS OF SERVICE

By using this plugin, you agree to the following terms, which may be updated by the author at any time.

All payments are final and non-refundable.
Redistribution or resale of this plugin is prohibited.
You are not permitted to modify, decompile, or extract any part of the plugin's source code.
Support is provided exclusively to legitimate customers. We cannot offer support for plugins obtained through unauthorized or illegal means.

bStats METRICS

This plugin collects anonymous server statistics through bStats.

This data (such as player count, server version, and Java version) helps us understand how the plugin is being used and allows us to make better development decisions. No private information is collected.

Enjoying the plugin?

We spend hundreds of hours making Santa Says the best minigame experience for your server.
If you like the plugin, please consider leaving a 5-star review!

A huge thank you to everyone who has purchased and supported the project so far! ❤️

View on SpigotMC

Resource Information

Author:

----------

Total Downloads: 3

First Release: Mar 8, 2026

Last Update: Mar 16, 2026

Category: ---------------

All-Time Rating:

0 ratings

Find more info at docs.despical.dev...

Version -----

Released: --------------------

Downloads: ------

Version Rating:

----------------------

-- ratings

Ask Questions / Get Support