A Minecraft plugin for creating and managing in-game giveaways with full customization and stats tracking.

Features

• Create giveaways using the item in your hand.
• Money giveaways via Vault (economy integration).
• Customizable currency formatting (symbols, positions, separators).
• Random winner selection with countdown.
• Tracks winners and displays statistics with a leaderboard.
• Full permission system with fine-grained access control.
• Customizable messages with color codes (standard & hex).
• Configurable sounds, cooldowns, timers.
• Visuals: Titles, Action Bars, Boss Bars.
• Celebration fireworks for winners.
• Supports Minecraft versions 1.20.1 to 1.21.4.

️ Commands

Command Description
/giveaway Start a giveaway with the item in your hand.
/giveaway item Explicitly create an item giveaway.
/giveaway money <amount> Start a money giveaway (Vault required).
/giveaway leaderboard or /giveaway top View top winners and your personal stats.
/giveaway reload Reload the plugin configuration.
Permissions

Permission Description Default
xgiveaway.use Allow creating any giveaway. OP
xgiveaway.item Allow creating item giveaways. OP
xgiveaway.money Allow creating money giveaways. OP
xgiveaway.reload Allow reloading the config. OP
xgiveaway.balance Allow seeing balance info. OP
xgiveaway.leaderboard Allow accessing the leaderboard. OP
⚙️ Configuration Overview
General Settings

• Cooldown Time: 15 seconds between giveaways.
• Pre-countdown Delay: 7 seconds wait before countdown starts.
• Countdown Start From: 3 seconds.
• Win Sound: ENTITY_PLAYER_LEVELUP.

Economy (Vault Required)

• Enabled: Money giveaways can be toggled.
• Max Giveaway Amount: 1,000,000.
• Show Balance: Displays balance after operations.
• Native Formatting: Use economy plugin's formatting.
• Currency Symbol: ₹ (customizable).
• Symbol Position: Prefix or Suffix.
• Symbol Spacing: Add space between symbol and amount.
• Decimal Places: Display up to 2 decimals.
• Separators: Use commas for thousands, periods for decimals.

Messages

• Prefix: [Giveaway] (styled).
• Broadcast Header/Footer: Stylish separator with plugin name.
• No Permission: “You don’t have permission...”
• No Item in Hand: “You need an item in your hand!”
• Cooldown Active: “Please wait X seconds.”
• Giveaway Created By: “Created by: [Player Name]”
• Prize Info: “Prize: [Item Name]”
• Countdown Message: “X seconds left.”
• Winner Message: “Winner: [Player Name]”

Color Code Support

• Standard: &a, &b, &c, etc.
• Hex: &#RRGGBB or #RRGGBB

How to Use
Item Giveaway

1. Give xgiveaway.use and xgiveaway.item permissions.
2. Hold an item in your hand.
3. Use /giveaway or /giveaway item.
4. The giveaway begins, counts down, and selects a random winner.

Money Giveaway

1. Install Vault + an economy plugin (e.g., EssentialsX).
2. Give xgiveaway.use and xgiveaway.money permissions.
3. Use /giveaway money <amount>.
4. Amount is deducted from your balance and awarded to the winner.

Balance Viewing

• Requires xgiveaway.balance permission.
• Shows player’s balance after creating or winning a money giveaway.

Leaderboard

• Permission: xgiveaway.leaderboard
• Commands: /giveaway leaderboard or /giveaway top
• Shows:
  • Top 10 winners with gold/silver/bronze highlights.
  • Player’s rank and win count.
• Automatically tracks wins.

Supported Versions

• Minecraft 1.20.1 to 1.21.4

Author

• GodXPro
• Discord: godxpro.exe