BubbleAnnounce

A highly configurable announcement plugin for Bukkit-based servers (Paper/Purpur/Folia/Spigot). Easy setup, modern text support, and lots of QoL.

✅ Compatibility

• Minecraft: 1.21+
• Java: 21
• Works on: Paper / Purpur / Folia / Spigot
• Not for proxies: Velocity / BungeeCord / Waterfall

✨ What it can do

• Send announcements to chat, actionbar, or titles
• Text formats: Legacy (& + hex #RRGGBB), MiniMessage, JSON Components
• Center messages with <center>...</center> (chat + actionbar)
• Fixed intervals or randomized intervals
• Hour windows + priority to reduce overlap
• Targeting + QoL: permissions, worlds, per-player cooldown, sounds, prefixes
• PlaceholderAPI support (optional)
• Folia-safe delivery

🚀 Install

1. Put BubbleAnnounce.jar in plugins/
2. Restart the server
3. Edit plugins/BubbleAnnounce/config.yml
4. Run /bubbleannounce reload

🧾 Config example

announcements:
  discord:
    enabled: true
    type: chat
    mode: legacy
    interval: 30
    messages:
      - "<center>&9★ &fJoin our &9&lDiscord&f server! &9★</center>"
    sound: "ENTITY_EXPERIENCE_ORB_PICKUP"
    cooldownSeconds: 300

📋 Commands

• /bubbleannounce reload
• /bubbleannounce list
• /bubbleannounce toggle <id>
• /bubbleannounce test <id>
• /bubbleannounce debug
• /runannouncements

🧩 PlaceholderAPI

If PlaceholderAPI is installed, placeholders will be applied per-player (e.g. %player_name%).