# ChristmasGift \ud83c\udf81
\nA festive Minecraft plugin featuring Christmas-themed loot boxes with tiered rewards, spectacular particle effects, and an intuitive admin GUI for complete reward management.<\/p>\n
\n
\n<\/p>\n
### \ud83c\udf1f Key Features
\n– **5-Tier Rarity System** – Common, Rare, Epic, Legendary, and Mythic rewards
\n– **Stunning Visual Effects** – Beautiful particle animations and sound effects when opening gifts
\n– **In-Game Admin GUI** – Manage tiers, rewards, and chances without editing files
\n– **Fully Configurable** – Customize everything from drop rates to reward commands
\n– **Economy Support** – Compatible with Vault and EssentialsX economy plugins
\n– **Smart Cooldown System** – Prevents spam with automatic cleanup
\n– **Broadcast System** – Announce special rewards to the entire server
\n– **Performance Optimized** – Efficient particle rendering and memory management<\/p>\n
### \ud83d\udccb Commands ### \u2699\ufe0f Configuration<\/p>\n **config.yml** # General settings # Combo system settings # Effects settings # Item settings **rewards.yml** tiers: rare: epic: legendary: mythic: ### \ud83c\udfae How to Use ### \ud83d\udd12 Permissions ### \ud83d\udcbb Requirements ### \ud83d\udd27 Installation ### \ud83c\udfa8 Customization ### \ud83c\udfaf Perfect For ### \ud83d\udc9d Support Development ### \ud83d\udcde Support & Community —<\/p>\n Made with \u2764\ufe0f for the Minecraft community<\/p>\n","protected":false},"excerpt":{"rendered":" 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<\/p>\n","protected":false},"featured_media":39940,"template":"","meta":{"_minecraft_slug":"christmasgift","_minecraft_project_id":"V8sHKReq","_minecraft_author":"ResistanceCore","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":774,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"christmasgift.zip","_minecraft_size_bytes":168623,"_minecraft_version_count":4,"_minecraft_updated_at":"2026-05-16T09:18:05.178144Z","_minecraft_date_created":"2025-10-22T21:49:50.552896Z","_minecraft_date_modified":"2025-12-03T12:15:20.150079Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/christmasgift","_minecraft_icon_attachment_id":39940,"_minecraft_imported_at":"2026-06-01T21:15:54+00:00","_minecraft_import_hash":"05dda06d44a9da125b92812ebef1cffd","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[844,89,127,92],"mod_loader":[132],"minecraft_version":[62,37,40,73,74,38,78,79,80,81,82],"class_list":["post-39939","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-economy","mod_category-game-mechanics","mod_category-paper","mod_category-utility","mod_loader-paper","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n“`
\n\/christmasgift – Open admin management GUI
\n\/christmasgift give
\n\/christmasgift reload – Reload all configurations
\n“`
\nQuick aliases: `\/cgift` or `\/xmasgift`<\/p>\n
\n“`yaml
\n# ChristmasGift Plugin Main Configuration<\/p>\n
\nsettings:
\n # Cooldown in milliseconds
\n gift-cooldown: 1000
\n # Whether to broadcast rewards to entire server
\n broadcast-rewards: true
\n # Broadcast message format
\n broadcast-format: “&a%player% received %reward% from Christmas Gift!”<\/p>\n
\ncombo:
\n # Enable\/disable combo system
\n enabled: true
\n # Combo timeout (in seconds)
\n timeout: 10
\n # Combo tiers with multipliers
\n tiers:
\n tier1:
\n gifts-required: 3
\n multiplier: 1.5
\n name: “# COMBO #”
\n color: “&b”
\n tier2:
\n gifts-required: 5
\n multiplier: 2.0
\n name: “* MEGA COMBO *”
\n color: “&6”
\n tier3:
\n gifts-required: 10
\n multiplier: 3.0
\n name: “@ ULTRA COMBO @”
\n color: “&d”<\/p>\n
\neffects:
\n # Effects when opening gift
\n enable-effects: true
\n enable-sounds: true
\n # Sound volume (0.0 – 1.0)
\n sound-volume: 1.0
\n # Sound pitch (0.0 – 2.0)
\n sound-pitch: 1.0<\/p>\n
\ngift:
\n # Display name for gift item
\n display-name: “&c&lChristmas Gift”
\n # Item description
\n lore:
\n – “&7Right click to open!”
\n – “&7+ Contains special rewards!”
\n – “&7+ From Common to Mythic”
\n – “”
\n – “&e&lCOMBO BONUS:”
\n – “&73+ gifts = 1.5x rewards”
\n – “&75+ gifts = 2.0x rewards”
\n – “&710+ gifts = 3.0x rewards”
\n # Material for gift item
\n material: CHEST
\n“`<\/p>\n
\n“`yaml
\n# Advanced Christmas Gift Plugin Configuration<\/p>\n
\n common:
\n chance: 45.0
\n color: “&f”
\n prefix: “&f[&aCommon Reward&f]”
\n rewards:
\n – “give %player% minecraft:diamond 2”
\n – “give %player% minecraft:emerald 3”
\n – “give %player% minecraft:cooked_beef 32”
\n – “eco give %player% 1000”
\n – “xp add %player% 500”
\n – “give %player% minecraft:iron_sword[minecraft:enchantments={levels:{“minecraft:sharpness”:3}}] 1″<\/p>\n
\n chance: 30.0
\n color: “&b”
\n prefix: “&f[&bRare Reward&f]”
\n rewards:
\n – “give %player% minecraft:diamond 5”
\n – “give %player% minecraft:emerald 8”
\n – “give %player% minecraft:netherite_ingot 1”
\n – “eco give %player% 5000”
\n – “xp add %player% 1000”
\n – “give %player% minecraft:enchanted_golden_apple 2”
\n – “give %player% minecraft:diamond_sword[minecraft:enchantments={levels:{“minecraft:sharpness”:4,”minecraft:looting”:2}}] 1″<\/p>\n
\n chance: 15.0
\n color: “&5”
\n prefix: “&f[&5Epic Reward&f]”
\n rewards:
\n – “give %player% minecraft:diamond 10”
\n – “give %player% minecraft:netherite_ingot 2”
\n – “give %player% minecraft:enchanted_golden_apple 5”
\n – “eco give %player% 10000”
\n – “give %player% minecraft:diamond_block 3”
\n – “give %player% minecraft:netherite_pickaxe[minecraft:enchantments={levels:{“minecraft:efficiency”:5,”minecraft:fortune”:3,”minecraft:unbreaking”:3}}] 1″
\n – “give %player% minecraft:diamond_sword[minecraft:enchantments={levels:{“minecraft:sharpness”:5,”minecraft:looting”:3,”minecraft:unbreaking”:3}}] 1″<\/p>\n
\n chance: 8.0
\n color: “&6”
\n prefix: “&f[&6Legendary Reward&f]”
\n rewards:
\n – “give %player% minecraft:netherite_ingot 5”
\n – “give %player% minecraft:diamond_block 5”
\n – “eco give %player% 50000”
\n – “give %player% minecraft:elytra[minecraft:enchantments={levels:{“minecraft:unbreaking”:3}}] 1″
\n – “give %player% minecraft:netherite_sword[minecraft:enchantments={levels:{“minecraft:sharpness”:5,”minecraft:looting”:3,”minecraft:unbreaking”:3,”minecraft:fire_aspect”:2}}] 1″
\n – “give %player% minecraft:netherite_axe[minecraft:enchantments={levels:{“minecraft:sharpness”:5,”minecraft:efficiency”:5,”minecraft:unbreaking”:3}}] 1″<\/p>\n
\n chance: 2.0
\n color: “&d”
\n prefix: “&f[&dMythic Reward&f]”
\n rewards:
\n – “give %player% minecraft:beacon 1”
\n – “eco give %player% 100000”
\n – “give %player% minecraft:dragon_egg 1”
\n – “give %player% minecraft:netherite_block 3”
\n – “give %player% minecraft:elytra[minecraft:enchantments={levels:{“minecraft:unbreaking”:3,”minecraft:mending”:1}}] 1″
\n – “give %player% minecraft:netherite_sword[minecraft:enchantments={levels:{“minecraft:sharpness”:5,”minecraft:looting”:3,”minecraft:unbreaking”:3,”minecraft:fire_aspect”:2,”minecraft:mending”:1,”minecraft:sweeping_edge”:3}}] 1″
\n“`<\/p>\n
\n1. **Get a Gift** – Use `\/christmasgift give 1` or receive from server events
\n2. **Open the Gift** – Right-click the Christmas Gift item
\n3. **Enjoy the Show** – Watch beautiful particle effects and animations
\n4. **Receive Rewards** – Get random rewards based on tier chances<\/p>\n
\n“`yaml
\nchristmasgift.admin: # Access all commands and GUI (default: op)
\n“`<\/p>\n
\n– **Server Type:** Paper 1.21.1+ (Spigot compatible)
\n– **Minecraft Version:** 1.21+
\n– **Java:** 17 or higher
\n– **Optional Dependencies:**
\n – Vault (for economy support)
\n – EssentialsX (for economy commands)<\/p>\n
\n1. Download the latest version from Modrinth
\n2. Place `ChristmasGift.jar` in your server’s `plugins` folder
\n3. Restart your server
\n4. Configure tiers and rewards in `plugins\/ChristmasGift\/rewards.yml`
\n5. Customize settings in `plugins\/ChristmasGift\/config.yml`
\n6. Use `\/christmasgift` to open the admin GUI<\/p>\n
\nThe plugin is **fully customizable** through the in-game GUI:
\n– \u270f\ufe0f Edit tier drop chances
\n– \ud83c\udfaf Add\/remove rewards for each tier
\n– \ud83c\udff7\ufe0f Customize tier prefixes and colors
\n– \ud83c\udf81 Create new custom tiers
\n– \u26a1 Real-time updates without restart<\/p>\n
\n– \u2728 Christmas\/Holiday events
\n– \ud83c\udf89 Server rewards and giveaways
\n– \ud83c\udfc6 Competition prizes
\n– \ud83d\udc8e VIP perks
\n– \ud83c\udf8a Special celebrations<\/p>\n
\nIf you find this plugin useful, please consider:
\n– \u2b50 Rating the plugin on Modrinth
\n– \ud83d\udce2 Sharing with other server owners
\n– \ud83d\udcac Leaving feedback and suggestions
\n– \ud83d\udc1b Reporting bugs to help improve<\/p>\n
\nNeed help or want to share your experience?
\n– **Discord:** https:\/\/discord.gg\/NJVHMSMR6m
\n– **Issues:** Report bugs on our issue tracker
\n– **Suggestions:** We welcome feature requests!<\/p>\n