VoidGiveaway BossBar ActionBar v2.6

This update brings one of the most requested features – Scheduled Giveaways – along with a brand-new config option for timezone support. Perfect for servers that want to automatically run giveaways at fixed times of the day!
Additionally, we fixed an issue where the BossBar would disappear too early when stopping or ending a giveaway. 🎉

🛠️ New in config.yml

[SPOILER="config.yml"]
[code=YAML]timezone: "Europe/Berlin"

scheduled-giveaways:
'1':
time: '11:15'
reward: diamond_pack
duration: 3m
announcements:
'1':
before: 2m
message: '&eThe &bDiamond Giveaway &estarts in 2 minutes!'
title:
main: '&bDiamond Giveaway'
sub: '&eStarting soon'
'2':
before: 30s
message: '&cOnly 30 seconds until the Diamond Giveaway!'
title:
main: '&cGet ready!'
sub: '&e30 seconds left'[/code]
[/SPOILER]

✅ Timezone Support → configure your server’s local timezone for consistent scheduling.
✅ Scheduled Giveaways → set exact times when giveaways start automatically.
✅ Custom Announcements → send countdown messages and titles before the giveaway begins.

🛠️ New in messages.yml

[SPOILER="messages.yml"]
[code=YAML]# Scheduled Giveaways
scheduled-start: "&aA scheduled giveaway has started! Reward: %item% &7(Duration: %time%)"
scheduled-broadcast: "%prefix%&eThe &6&lDaily Keyall &eis active! Type &6&l/giveaway join&e to enter! Ends in &6&l%time%&e."[/code]
[/SPOILER]

✅ scheduled-start → clean broadcast when a scheduled giveaway begins.
✅ scheduled-broadcast → promote your daily / timed giveaways with placeholders for reward & duration.

🐛 Fixes

• Fixed: BossBar no longer disappears too early when a giveaway is stopped or ends.

🚀 Why this matters

• Fully automate daily giveaways – no more manual starting!

• Increase player engagement with countdown messages and hype builds.

• Flexible configuration per timezone, great for international servers.

• More polished giveaway visuals thanks to the BossBar fix.

✨ Pro tip: Combine scheduled giveaways with your existing reward packs to create unique daily events like Keyalls, Rank Drops, or Lootbox Giveaways!

Fixes

• No more unexpected errors when starting a giveaway.

Fixes

• Improved error handling for /admingiveaway stop.
  No more unexpected errors when stopping a giveaway.

Config & Messages

• The plugin now automatically adds missing config and message sections on update.
• Your existing edits remain untouched.
• Only missing keys from new versions will be added.

Blocked Items Feature

• Server owners can now block specific items from being used as giveaway rewards.
• Block by:
  
  • Material (e.g., DIAMOND_SWORD)
  • Custom item names
  • Enchantments with level conditions (e.g., DAMAGE_ALL: ">=5" or FIRE_ASPECT: "<=1")
• Supports unlimited blocked items through the config.

Improved Time Display

• Giveaway countdowns no longer show only raw seconds.
• Example:
  • 90s → now displayed as 1m 30s
  • 3600s → displayed as 1h
  • 3675s → displayed as 1h 1m 15s

This makes countdowns in the ActionBar, BossBar, and messages more user-friendly and easier to read.

New Feature

• Update Checker:
  The plugin now checks if your server is running the latest version of VoidGiveaway.
  • If a newer version is available, you’ll be notified in console and in-game (for admins).
  • Keeps your plugin always up-to-date with the newest features and fixes.

This update is lightweight and has no impact on performance.
Stay informed, never miss an update again!

• Giveaway History GUI
  View all past giveaways in an interactive GUI with multiple pages. Each entry shows host, winner, reward, and date.
  
  
• SQLite-Powered Storage
  History entries are permanently saved in an SQLite database and persist after restarts.
  
  
• Configurable GUI Items
  Fully customizable item name, lore, size, and navigation buttons inside config.yml.
  
  
• PersistentData Navigation
  Items in the GUI are tracked with PersistentData for reliable page-switching and interaction.

• /admingiveaway history – Open the Giveaway History GUI (Admin only).

• voidgiveaway.admin.history – Required to view the history GUI.

✅ BossBar Support – Show live countdowns and prize info directly in the BossBar!
✅ ActionBar Support – Displays quick giveaway updates in the ActionBar (configurable interval).
✅ /admingiveaway toggle – Temporarily disable player giveaways (only admins can start giveaways).
✅ Improved Config – Completely rewritten for readability, now with detailed descriptions and more options.

New Features:
• Added /giveaway stats command to view personal giveaway stats (wins, participations, last win date).
• Added /giveaway top command to display the top 10 players with the most wins and participations.
• Implemented database saving with support for MySQL and SQLite.
• Introduced anti-reload loss so active giveaways persist through plugin reloads.


Permissions:
• voidgiveaway.stats – Access to /giveaway stats.
• voidgiveaway.top – Access to /giveaway top.

✨ New Features:
• Added Discord Webhook support (start, countdown, winner, no-winner, cancelled).
• New config.yml section for Discord integration.

🐛 Fixes:
• Fixed error with /admingiveaway stop.
• config.yml & messages.yml are now always editable, even after errors.

  discord:
    webhook-url: "https://discord.com/api/webhooks/1983737/AIFHSJ"
    enabled: false
    send-countdown-updates: false
    messages:
      giveaway-start: "🎉 **New Giveaway Started!** Host: **%host%** Prize: **%prize%** Time Remaining: **%time%s**"
      countdown: "⏳ Giveaway for **%prize%** – Time left: **%time%s**"
      winner: "🏆 **Giveaway Ended!** Prize: **%prize%** Winner: **%winner%**"
      no-winner: "🏆 **Giveaway Ended!** Prize: **%prize%** No one participated 😢"
      cancelled: "❌ **Giveaway Cancele** Prize: **%prize%** The giveaway was cancelled."

Discord:

• Improved: Optimized parts of the code to enhance plugin reliability.

Changes

• Some configuration messages rewritten for cleaner & more flexible customization

Info

• Added detailed /admingiveaway information to see the information of the current running giveaway

Permissions

• New permission: voidgiveaway.admin.information

 New Features​

• Custom Placeholder Defaults
  Added a new placeholders section in the configuration to define what should be displayed when no giveaway is running.
  Example:
  
  
  YAML:

  placeholders: # when no giveaway running
  name: "&cNo Giveaway Running"
  host-name: "&cx"
  time-left: "&cx"
  current-entries: "&ax"

  This gives you full control over how placeholders look when the giveaway is inactive.

 Improvements​

• Placeholders are now more null-safe, preventing empty or broken values if no giveaway is active.
• Better integration with PlaceholderAPI.

🛠 Fixes​

• Fixed cases where placeholders would return nothing if a giveaway was not active.
• General code cleanup and performance stability improvements.
  
  
  
  
  
   

New

• If a giveaway ends with no participants, the host will automatically get the item back [This can be disabled in the config].

Fix

• Resolved a bug where no new giveaway could be started while the rolling animation was still running.

• New: Added Rolling Titles for giveaway announcements!
  • Participant names are displayed one after another in the title.
  • At the end, the winner is highlighted in the title.
  • Demo: GIF
• This adds more excitement and a better experience for giveaways and events.
• Existing messages and rewards remain fully compatible.

• Added PlaceholderAPI support for messages! You can now use placeholders in all plugin messages to show dynamic content.