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

• 5-Tier Rarity System - Common, Rare, Epic, Legendary, and Mythic rewards
• Stunning Visual Effects - Beautiful particle animations and sound effects when opening gifts
• In-Game Admin GUI - Manage tiers, rewards, and chances without editing files
• Fully Configurable - Customize everything from drop rates to reward commands
• Economy Support - Compatible with Vault and EssentialsX economy plugins
• Smart Cooldown System - Prevents spam with automatic cleanup
• Broadcast System - 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

# 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

# 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. Get a Gift - Use /christmasgift give 1 or receive from server events
2. Open the Gift - Right-click the Christmas Gift item
3. Enjoy the Show - Watch beautiful particle effects and animations
4. Receive Rewards - Get random rewards based on tier chances

🔒 Permissions

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

💻 Requirements

• Server Type: Paper 1.21.1+ (Spigot compatible)
• Minecraft Version: 1.21+
• Java: 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?

• Discord: https://discord.gg/NJVHMSMR6m
• Issues: Report bugs on our issue tracker
• Suggestions: We welcome feature requests!

---

Made with ❤️ for the Minecraft community