christmasgift

ChristmasGift 🎁

A festive Minecraft plugin featuring Christmas-themed loot boxes with tiered rewards, spectacular particle effects, and an intuitive admin GUI for complete reward management.

🌟 Key Features

- Performance Optimized - Common, Rare, Epic, Legendary, and Mythic rewards - Performance Optimized - Beautiful particle animations and sound effects when opening gifts - Performance Optimized - Manage tiers, rewards, and chances without editing files - Performance Optimized - Customize everything from drop rates to reward commands - Performance Optimized - Compatible with Vault and EssentialsX economy plugins - Performance Optimized - Prevents spam with automatic cleanup - Performance Optimized - Announce special rewards to the entire server - Performance Optimized - Efficient particle rendering and memory management

📋 Commands

``` /christmasgift - Open admin management GUI /christmasgift give <amount> - Give Christmas gifts to yourself /christmasgift reload - Reload all configurations ``` Quick aliases: `/cgift` or `/xmasgift`

⚙️ Configuration

config.yml ```yaml

ChristmasGift Plugin Main Configuration

General settings

settings:

Cooldown in milliseconds

gift-cooldown: 1000

Whether to broadcast rewards to entire server

broadcast-rewards: true

Broadcast message format

broadcast-format: "&a%player% received %reward% from Christmas Gift!"

Combo system settings

combo:

Enable/disable combo system

enabled: true

Combo timeout (in seconds)

timeout: 10

Combo tiers with multipliers

tiers: tier1: gifts-required: 3 multiplier: 1.5 name: "# COMBO #" color: "&b" tier2: gifts-required: 5 multiplier: 2.0 name: "* MEGA COMBO *" color: "&6" tier3: gifts-required: 10 multiplier: 3.0 name: "@ ULTRA COMBO @" color: "&d"

Effects settings

effects:

Effects when opening gift

enable-effects: true enable-sounds: true

Sound volume (0.0 - 1.0)

sound-volume: 1.0

Sound pitch (0.0 - 2.0)

sound-pitch: 1.0

Item settings

gift:

Display name for gift item

display-name: "&c&lChristmas Gift"

Item description

lore: - "&7Right click to open!" - "&7+ Contains special rewards!" - "&7+ From Common to Mythic" - "" - "&e&lCOMBO BONUS:" - "&73+ gifts = 1.5x rewards" - "&75+ gifts = 2.0x rewards" - "&710+ gifts = 3.0x rewards"

Material for gift item

material: CHEST ```

rewards.yml ```yaml

Advanced Christmas Gift Plugin Configuration

tiers: common: chance: 45.0 color: "&f" prefix: "&f[&aCommon Reward&f]" rewards: - "give %player% minecraft:diamond 2" - "give %player% minecraft:emerald 3" - "give %player% minecraft:cooked_beef 32" - "eco give %player% 1000" - "xp add %player% 500" - "give %player% minecraft:iron_sword[minecraft:enchantments={levels:{"minecraft:sharpness":3}}] 1"

rare: chance: 30.0 color: "&b" prefix: "&f[&bRare Reward&f]" rewards: - "give %player% minecraft:diamond 5" - "give %player% minecraft:emerald 8" - "give %player% minecraft:netherite_ingot 1" - "eco give %player% 5000" - "xp add %player% 1000" - "give %player% minecraft:enchanted_golden_apple 2" - "give %player% minecraft:diamond_sword[minecraft:enchantments={levels:{"minecraft:sharpness":4,"minecraft:looting":2}}] 1"

epic: chance: 15.0 color: "&5" prefix: "&f[&5Epic Reward&f]" rewards: - "give %player% minecraft:diamond 10" - "give %player% minecraft:netherite_ingot 2" - "give %player% minecraft:enchanted_golden_apple 5" - "eco give %player% 10000" - "give %player% minecraft:diamond_block 3" - "give %player% minecraft:netherite_pickaxe[minecraft:enchantments={levels:{"minecraft:efficiency":5,"minecraft:fortune":3,"minecraft:unbreaking":3}}] 1" - "give %player% minecraft:diamond_sword[minecraft:enchantments={levels:{"minecraft:sharpness":5,"minecraft:looting":3,"minecraft:unbreaking":3}}] 1"

legendary: chance: 8.0 color: "&6" prefix: "&f[&6Legendary Reward&f]" rewards: - "give %player% minecraft:netherite_ingot 5" - "give %player% minecraft:diamond_block 5" - "eco give %player% 50000" - "give %player% minecraft:elytra[minecraft:enchantments={levels:{"minecraft:unbreaking":3}}] 1" - "give %player% minecraft:netherite_sword[minecraft:enchantments={levels:{"minecraft:sharpness":5,"minecraft:looting":3,"minecraft:unbreaking":3,"minecraft:fire_aspect":2}}] 1" - "give %player% minecraft:netherite_axe[minecraft:enchantments={levels:{"minecraft:sharpness":5,"minecraft:efficiency":5,"minecraft:unbreaking":3}}] 1"

mythic: chance: 2.0 color: "&d" prefix: "&f[&dMythic Reward&f]" rewards: - "give %player% minecraft:beacon 1" - "eco give %player% 100000" - "give %player% minecraft:dragon_egg 1" - "give %player% minecraft:netherite_block 3" - "give %player% minecraft:elytra[minecraft:enchantments={levels:{"minecraft:unbreaking":3,"minecraft:mending":1}}] 1" - "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" ```

🎮 How to Use

1. Receive Rewards - Use `/christmasgift give 1` or receive from server events 2. Receive Rewards - Right-click the Christmas Gift item 3. Receive Rewards - Watch beautiful particle effects and animations 4. Receive Rewards - Get random rewards based on tier chances

🔒 Permissions

```yaml christmasgift.admin: # Access all commands and GUI (default: op) ```

💻 Requirements

- Optional Dependencies: Paper 1.21.1+ (Spigot compatible) - Optional Dependencies: 1.21+ - Optional Dependencies: 17 or higher - Optional Dependencies: - Vault (for economy support) - EssentialsX (for economy commands)

🔧 Installation

1. Download the latest version from Modrinth 2. Place `ChristmasGift.jar` in your server's `plugins` folder 3. Restart your server 4. Configure tiers and rewards in `plugins/ChristmasGift/rewards.yml` 5. Customize settings in `plugins/ChristmasGift/config.yml` 6. Use `/christmasgift` to open the admin GUI

🎨 Customization

The plugin is fully customizable through the in-game GUI: - ✏️ Edit tier drop chances - 🎯 Add/remove rewards for each tier - 🏷️ Customize tier prefixes and colors - 🎁 Create new custom tiers - ⚡ Real-time updates without restart

🎯 Perfect For

- ✨ Christmas/Holiday events - 🎉 Server rewards and giveaways - 🏆 Competition prizes - 💎 VIP perks - 🎊 Special celebrations

💝 Support Development

If you find this plugin useful, please consider: - ⭐ Rating the plugin on Modrinth - 📢 Sharing with other server owners - 💬 Leaving feedback and suggestions - 🐛 Reporting bugs to help improve

📞 Support & Community

Need help or want to share your experience? - Suggestions: Suggestions: - Suggestions: Report bugs on our issue tracker - Suggestions: We welcome feature requests!

---

Made with ❤️ for the Minecraft community