Sueta

christmasgift

1.4.0

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 admi

·Plugin
Tested MC versions
1.21, 26.1, 26.2

ChristmasGift

Christmas loot boxes with tiers, combos and a roulette, all managed from an in-game menu.

Version 1.4.0
Minecraft 1.21 - 26.2
Paper
Java 21
Discord


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

FeatureDetails
Tiered rewardsCommon, Rare, Epic, Legendary and Mythic out of the box. Add as many tiers as you want.
Combo systemOpen gifts quickly one after another and the rewards get multiplied.
Admin menuChange chances, add/edit/remove rewards and create tiers in game. Shows the real drop % of every tier.
BroadcastsOptionally tell the whole server what someone just got.
TranslationsEvery message and GUI text is in a language file. English and Indonesian included.
No lost rewardsLogged out or server restarted while a gift was opening? The reward is given on the next join.
Can't be fakedGifts have a hidden tag, a renamed chest won't work.

How it works

  1. An admin gives gifts with /cgift give <amount> <player> (works from console too, so crates, votes and events can hand them out).
  2. The player holds the gift and presses Right Click.
  3. The roulette spins and lands on a tier based on the chances you set.
  4. 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 rowReward multiplier
3+1.5x
5+2x
10+3x

All of these can be changed in config.yml.

Default tiers

TierChanceExample rewards
Common45%Diamonds, emeralds, $1,000, skill XP
Rare30%Netherite ingot, enchanted golden apples, $5,000
Epic15%Diamond blocks, $10,000, 2,000 XP in all skills
Legendary8%Elytra, netherite sword, $50,000
Mythic2%Beacon, dragon egg, $100,000

Commands

CommandDescription
/christmasgiftOpens the admin menu
/christmasgift give <amount> [player]Gives 1-64 gifts (player is required from console)
/christmasgift reloadReloads 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, xp and skills xp add commands. Other commands run as they are.
  • Add display-name to 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

ServerPaper 1.21 - 1.21.11 or 26.2. Forks like Purpur should work too. Spigot is not supported.
Java21 (Paper 26.x runs on Java 25 anyway)
Required pluginsNone
OptionalEssentialsX or any plugin with an eco give command for money rewards, AuraSkills for skill XP

Installation

  1. Put the jar in your plugins folder.
  2. Restart the server (don't use /reload).
  3. Set up your tiers in rewards.yml or in game with /cgift.
  4. 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.

Similar projects

Plugin →