🎃 PumpkinAnnouncer

The ultimate all-in-one announcement system, now natively supporting Paper servers and Velocity proxies in a single file! PumpkinAnnouncer lets you create immersive, high-quality messages with full support for Chat, ActionBars, BossBars, and custom Sounds.

✨ Features

• 🌐 True Multi-Platform (1 File): No more downloading separate versions. Drop the same JAR into your Paper plugins folder or your Velocity plugins folder, and it will intelligently detect where it's running.
• 🎨 Universal Color Support: Mix and match Legacy codes (&a&l), BungeeHex (&#FF0000), and MiniMessage (<gradient:red:blue>) in the same line. The plugin handles the conversion magic for you!
• 🪧 BossBars & ActionBars: Grab your players' attention with temporary BossBars and scrolling text above the health bar, complete with customizable sounds.
• 🎯 Network-Aware (Velocity): Send announcements across your entire network (global) or target specific servers only (e.g., ["lobby", "survival"]).
• 📏 Smart Centering: Just use the [center] tag at the start of any line. The plugin mathematically centers the text in the Minecraft chat, ignoring color codes to ensure it looks perfect every time.
• 🖱️ Interactive Messages: Full MiniMessage support for <click> and <hover> tags—perfect for links or tooltips.
• ⌨️ Pro Tab-Completion: No more guessing! Use /pa test and the plugin will automatically suggest the IDs of your created announcements.

---

📜 Commands & Permissions

Command	Description	Permission
/pa reload	Reloads the configuration in real-time.	pumpkin.admin
/pa list	Displays a list of all currently loaded announcements.	pumpkin.admin
/pa test <id>	Instantly previews a specific announcement.	pumpkin.admin

Note: When using /pa test, simply press TAB to see your available announcement IDs.

---

🛠️ Installation

1. Download the PumpkinAnnouncer.jar file.
2. Drop it into your Velocity or Paper plugins folder.
3. Restart your proxy or server.
4. Customize your settings in plugins/pumpkinannouncer/config.yml.
5. Run /pa reload in-game or via console to apply your changes.

---

📖 Announcement Examples (config.yml)

Here are a few ways you can set up your messages using the MiniMessage format.

1. Global Centered Announcement (e.g., Discord)

This message goes to every server (global), is perfectly centered, and features a clickable link.

  discord:
    servers: ["global"]
    lines:
      - "[center]<color:#A0C4FF><bold>DISCORD</bold>"
      - ""
      - "[center]<white>Join our official community!"
      - "[center]<white>Link: <click:open_url:'https://discord.gg/yourlink'><hover:show_text:'<gray>Click to join!'><underlined><color:#A0C4FF>discord.gg/yourlink</color></underlined></hover></click>"
      - "[center]<gray>» <white>Giveaways, support, and daily updates."

2. Targeted Server Announcement

Perfect for messages that only make sense in specific game modes like Survival or Skyblock.

  vote:
    servers: ["survival", "skyblock"]
    lines:
      - "[center]<gradient:green:yellow><bold>VOTE FOR THE SERVER!</bold></gradient>"
      - ""
      - "[center]<white>Support us by voting every day."
      - "[center]<white>Use <gold>/vote</gold> to claim your rewards."
      - "[center]<gray>Thanks for being part of our world!"

3. Basic Informational (Standard Alignment)

  cleanup:
    servers: ["global"]
    lines:
      - "<red><bold>⚠ IMPORTANT NOTICE</bold>"
      - "<white>Ground items are cleared every 15 minutes."
      - "<white>Make sure to keep your valuables safe!"

⚙️ General Settings

You can tweak the timing and plugin prefixes at the top of your config.yml:

settings:
  cooldown-seconds: 300 # 300 seconds = 5 minutes

messages:
  help: "<gradient:gold:yellow><bold>PumpkinAnnouncer</bold></gradient>\n<gray>» <yellow>/pa reload <dark_gray>- <white>Reload\n<gray>» <yellow>/pa list <dark_gray>- <white>View IDs\n<gray>» <yellow>/pa test <id> <dark_gray>- <white>Preview"
  reload-success: "<green>Config reloaded! You're good to go."
  list-header: "<gold><bold>Currently Loaded Announcements:</bold></gold>"
  id-not-found: "<red>That ID doesn't exist. Check your config!"