christmasgift
A festive Minecraft plugin that adds Christmas-themed loot boxes with a tiered reward system (Common to Mythic), featuring spectacular particle effects, sound animations, and a fully configurable admin GUI for managing rewards and drop rate
Описание
ChristmasGift
Christmas loot boxes with tiers, combos and a roulette, all managed from an in-game menu.
What is it?
A player right-clicks a gift, a roulette spins through the tiers with particles and sounds, and they get a random reward from the tier it lands on. Rewards are plain console commands, so you can give items, money, XP, ranks, crate keys or anything else another plugin can do with a command.
Features
| Feature | Details |
|---|---|
| Tiered rewards | Common, Rare, Epic, Legendary and Mythic out of the box. Add as many tiers as you want. |
| Combo system | Open gifts quickly one after another and the rewards get multiplied. |
| Admin menu | Change chances, add/edit/remove rewards and create tiers in game. Shows the real drop % of every tier. |
| Broadcasts | Optionally tell the whole server what someone just got. |
| Translations | Every message and GUI text is in a language file. English and Indonesian included. |
| No lost rewards | Logged out or server restarted while a gift was opening? The reward is given on the next join. |
| Can't be faked | Gifts have a hidden tag, a renamed chest won't work. |
How it works
- An admin gives gifts with
/cgift give <amount> <player>(works from console too, so crates, votes and events can hand them out). - The player holds the gift and presses Right Click.
- The roulette spins and lands on a tier based on the chances you set.
- One random reward from that tier is given, with a title on screen and an optional broadcast.
Combos
Each gift opened within 10 seconds of the previous one keeps the combo going.
| Gifts in a row | Reward multiplier |
|---|---|
| 3+ | 1.5x |
| 5+ | 2x |
| 10+ | 3x |
All of these can be changed in config.yml.
Default tiers
| Tier | Chance | Example rewards |
|---|---|---|
| Common | 45% | Diamonds, emeralds, $1,000, skill XP |
| Rare | 30% | Netherite ingot, enchanted golden apples, $5,000 |
| Epic | 15% | Diamond blocks, $10,000, 2,000 XP in all skills |
| Legendary | 8% | Elytra, netherite sword, $50,000 |
| Mythic | 2% | Beacon, dragon egg, $100,000 |
Commands
| Command | Description |
|---|---|
/christmasgift | Opens the admin menu |
/christmasgift give <amount> [player] | Gives 1-64 gifts (player is required from console) |
/christmasgift reload | Reloads config, rewards and language |
Aliases: /cgift and /xmasgift
Permission: christmasgift.admin for all commands and the admin menu (op by default). Players don't need any permission to open gifts.
Configuration
rewards.yml example
Every tier has a chance (a weight, it doesn't need to add up to 100) and a list of commands. One command is picked at random and %player% is replaced with the player's name.
tiers:
rare:
chance: 30.0
color: "&b"
prefix: "&f[&bRare Reward&f]"
rewards:
- "give %player% minecraft:diamond 5"
- "eco give %player% 5000"
- "skills xp add %player% all 1000"
- The combo multiplier scales the amount in
give,eco give,xpandskills xp addcommands. Other commands run as they are. - Add
display-nameto a tier if you want players to see a different name than the tier key.
AuraSkills "all" skills
AuraSkills has no option to give XP in every skill at once, so the plugin does it for you. skills xp add %player% all <amount> gives the amount in every skill listed under auraskills.enabled-skills in config.yml. Remove the skills you don't use on your server.
Languages
Set settings.language in config.yml to en or id. The files are in plugins/ChristmasGift/lang/ and you can edit them however you like.
For another language, copy en.yml to something like es.yml, translate it and set language: es. Anything you don't translate falls back to English. Set a message to "" if you don't want it sent at all.
Item names in reward messages show up in each player's own game language.
config.yml
Cooldown between gifts, broadcast on/off, the combo tiers (gifts needed, multiplier, name, color), effects and sounds, and the gift item itself (name, lore, material). Everything is explained inside the file.
Requirements
| Server | Paper 1.21 - 1.21.11 or 26.2. Forks like Purpur should work too. Spigot is not supported. |
| Java | 21 (Paper 26.x runs on Java 25 anyway) |
| Required plugins | None |
| Optional | EssentialsX or any plugin with an eco give command for money rewards, AuraSkills for skill XP |
Installation
- Put the jar in your
pluginsfolder. - Restart the server (don't use
/reload). - Set up your tiers in
rewards.ymlor in game with/cgift. - Start handing out gifts.
Found a bug or have an idea? Come say hi on Discord.
If you like the plugin, a follow on Modrinth helps a lot.