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 `...` (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

```yaml announcements: discord: enabled: true type: chat mode: legacy interval: 30 messages: - "

&9★ &fJoin our &9&lDiscord&f server! &9★" sound: "ENTITY_EXPERIENCE_ORB_PICKUP" cooldownSeconds: 300 ```

## 📋 Commands

• `/bubbleannounce reload`
• `/bubbleannounce list`
• `/bubbleannounce toggle `
• `/bubbleannounce test `
• `/bubbleannounce debug`
• `/runannouncements`

## 🧩 PlaceholderAPI

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