christmasgift

Minecraft 版本： 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10

平台： paper

标签： economy game-mechanics utility

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