🦆 DuckAnnouncer

DuckAnnouncer is a lightweight, high-performance, and fully customizable Paper/Spigot plugin designed to keep your community engaged with automated server announcements and an interactive in-game giveaway system.

Built using modern Adventure components, it delivers gorgeous chat displays complete with clickable links, hover tooltips, and customizable styles.

---

✨ Features

• Rotating Server Announcements: Automatically broadcasts custom messages at a configurable interval (in seconds).
• Interactive Announcements: Supports clickable buttons with custom hover text for store pages, Discord invites, and voting links.
• In-Game Giveaway System: Allows players to participate in custom giveaways directly from chat.
• Clickable Entries & Discord Integration: Players can click an interactive chat button or run a command to join, triggering a customizable confirmation message with a direct Discord link.
• Flexible Administration: Full control for staff members to host, end, or reroll giveaways instantly.
• Fully Configurable: Every single line, prefix, style, and interval can be modified inside config.yml.

---

🎮 Commands & Usage

👥 Player Commands

• /giveaway join - Enter the currently active giveaway. (Can also be triggered by clicking the broadcast chat button!)
• /giveaway leave - Leave the active giveaway if you change your mind.
• /giveaway count - Check the total number of players currently participating.
• /giveaway time - Check the exact time remaining before the giveaway ends.

🛡️ Admin Commands (Requires permission: duckannouncer.admin)

• /giveaway host <prize> <days> <winners> - Start a new giveaway.
  • Example: /giveaway host VIP_Rank 1 2 (Hosts a giveaway for a VIP rank lasting 1 day with 2 winners).
• /giveaway end <prize> - Force-end the current active giveaway early and pick the winner(s).
• /giveaway reroll <prize> - Randomly pick a new winner from the existing entry pool if needed.
• /duckannouncer reload - Reloads the config.yml file instantly without restarting the server.

---

⚙️ Configuration (config.yml)

The plugin features a clean, well-structured configuration file allowing you to control:

• Announcement and giveaway timing intervals.
• Custom prefixes, headers, and footer lines using legacy color codes (&).
• Giveaway prize headers, duration layouts, and Discord links.

---

📥 Installation

1. Download the latest DuckAnnouncer.jar file from the releases.
2. Drop the .jar file into your server's plugins/ directory.
3. Start or restart your server to generate the default configuration files.
4. Customize plugins/DuckAnnouncer/config.yml to fit your server's style.
5. Run /duckannouncer reload in-game or console to apply changes!