Ancient-Broadcast

# 📢 Ancient-Broadcast Ancient-Broadcast is a modern, lightweight, and highly configurable broadcast plugin for **Paper / Spigot 1.20+**, built with **Java 21**. ✨ Designed to be **lag-free**, scalable, and easy to manage for both small and large servers. Ancient-Broadcast allows server owners to send **professional-looking broadcasts** to all online players, either automatically on a schedule ⏱️ or manually via commands 🧑‍💻. Everything can be configured in-game or via the configuration file. --- ## 🧩 What Ancient-Broadcast does Ancient-Broadcast periodically sends messages (broadcasts) to **all online players** 👥. Every broadcast is always sent in the same clean format 🧼: - ➖ one empty spacer line - 📢 the broadcast message block (single-line or multi-line group) - ➖ one empty spacer line 🔊 Optionally, a sound is played for all players when the broadcast is sent. This keeps chat readable and prevents spam 🚫. --- ## ✨ Features (complete and explained) ### ⏱️ Scheduled broadcasts Each broadcast has its own scheduler and runs independently from others. Supported interval units: - ⏲️ SECONDS - ⏰ MINUTES - 🕒 HOURS This allows you to run multiple broadcasts at different intervals at the same time. --- ### 🔁 Rotation system If a broadcast contains multiple messages or multiple groups, rotation can be enabled. Rotation modes: - 🔢 **SEQUENTIAL** – messages or groups are sent in order - 🎲 **RANDOM** – a random message or group is selected each time Rotation is controlled globally and can be enabled, disabled, and switched between modes. --- ### ⭐ Grouped broadcasts (multi-line as ONE broadcast) Grouped broadcasts allow multiple lines to be linked together and sent as **one complete broadcast block**. 🔄 Rotation happens per group, not per line. Grouped broadcasts are ideal for: - 💡 tips with multiple lines - 📣 announcements - 🏷️ server information blocks - 🔗 messages containing clickable links When sent, a grouped broadcast appears between one spacer line above and one spacer line below. --- ### 🎨 Colors & formatting Ancient-Broadcast supports both modern and classic formatting systems. 🧩 **MiniMessage** is fully supported, including colors, gradients, formatting, and click events. 🎨 **Minecraft & color codes** are also supported: - &0 – &9 - &a – &f - &l **bold** - &o *italic* - &n underline - &m strikethrough - &k magic - &r reset - 🌈 HEX colors using &#RRGGBB MiniMessage and & color codes can be mixed in the same message. --- ### 🔗 Clickable links & websites Clickable links are supported using MiniMessage click events 🖱️. This allows linking: - 🌍 websites - 💬 Discord invites - 🛒 web shops - 🔗 any external URL --- ### 🔊 Sounds Each broadcast can optionally play a sound 🎵. Sound features: - 🔇 enable or disable sounds per broadcast - 🔔 choose a custom sound per broadcast - 🔊 custom volume - 🎚️ custom pitch - 🎛️ a global default sound The default sound is also used by the **broadcast-now** command. 📄 On first startup, the plugin automatically generates a `sounds.yml` file in the plugin folder. This file contains **all valid sound names** you can use in the configuration or commands. --- ### 🔌 PlaceholderAPI support If **PlaceholderAPI** is installed, placeholders work automatically 🧩. Examples: - `%player_name%` - `%vault_eco_balance%` Placeholders are resolved **per player**, meaning each player sees their own data 👤. PlaceholderAPI is optional — the plugin works perfectly without it. --- ### ⚡ Performance & optimization Ancient-Broadcast is optimized to be fast and lag-free 🚀: - ⚙️ uses the Paper scheduler - 🚫 no blocking operations - 🧠 cached message parsing - 🔍 PlaceholderAPI only used if installed and needed - 🛡️ safe sound resolution (Paper 1.21+ compatible) --- ## 📦 Requirements - ☕ Java 21 - 🧱 Paper / Spigot 1.20+ (Paper recommended) - 🧩 Optional: PlaceholderAPI --- ## 🚀 Installation 1️⃣ Download the Ancient-Broadcast jar file 2️⃣ Place it into the server **plugins** folder 3️⃣ Start the server once (generates config.yml and sounds.yml) 4️⃣ Edit `plugins/Ancient-Broadcast/config.yml` 5️⃣ Apply changes using `/ab reload` 6️⃣ Enable broadcasting globally using `/ab toggle` ⚠️ The plugin is **disabled by default**. --- ## 🔐 Permissions All commands require OP or the following permission 🔑: `ancientbroadcast.admin` Default: OP --- ## 🧑‍💻 Commands (complete list with explanation) ### 📋 General - `/ab help` – 📖 shows all available commands - `/ab reload` – 🔄 reloads the configuration file - `/ab toggle` – 🔌 global enable or disable switch - `/ab list` – 📄 lists all broadcasts and their status ### 📢 Broadcast management - `/ab add <id>` – ➕ create a new broadcast - `/ab remove <id>` – ❌ delete a broadcast - `/ab enable <id>` – ✅ enable a broadcast - `/ab disable <id>` – 🚫 disable a broadcast ### ✏️ Message editing - `/ab setmessage <id> <message>` – ✍️ set a single mess