# \ud83d\udce2 Ancient-Broadcast<\/p>\n
Ancient-Broadcast is a modern, lightweight, and highly configurable broadcast plugin for **Paper \/ Spigot 1.20+**, built with **Java 21**.
\n\u2728 Designed to be **lag-free**, scalable, and easy to manage for both small and large servers.<\/p>\n
Ancient-Broadcast allows server owners to send **professional-looking broadcasts** to all online players, either automatically on a schedule \u23f1\ufe0f or manually via commands \ud83e\uddd1\u200d\ud83d\udcbb. Everything can be configured in-game or via the configuration file.<\/p>\n
—<\/p>\n
## \ud83e\udde9 What Ancient-Broadcast does<\/p>\n
Ancient-Broadcast periodically sends messages (broadcasts) to **all online players** \ud83d\udc65.<\/p>\n
Every broadcast is always sent in the same clean format \ud83e\uddfc:
\n– \u2796 one empty spacer line
\n– \ud83d\udce2 the broadcast message block (single-line or multi-line group)
\n– \u2796 one empty spacer line<\/p>\n
\ud83d\udd0a Optionally, a sound is played for all players when the broadcast is sent.
\nThis keeps chat readable and prevents spam \ud83d\udeab.<\/p>\n
—<\/p>\n
## \u2728 Features (complete and explained)<\/p>\n
### \u23f1\ufe0f Scheduled broadcasts
\nEach broadcast has its own scheduler and runs independently from others.
\nSupported interval units:
\n– \u23f2\ufe0f SECONDS
\n– \u23f0 MINUTES
\n– \ud83d\udd52 HOURS<\/p>\n
This allows you to run multiple broadcasts at different intervals at the same time.<\/p>\n
—<\/p>\n
### \ud83d\udd01 Rotation system
\nIf a broadcast contains multiple messages or multiple groups, rotation can be enabled.<\/p>\n
Rotation modes:
\n– \ud83d\udd22 **SEQUENTIAL** \u2013 messages or groups are sent in order
\n– \ud83c\udfb2 **RANDOM** \u2013 a random message or group is selected each time<\/p>\n
Rotation is controlled globally and can be enabled, disabled, and switched between modes.<\/p>\n
—<\/p>\n
### \u2b50 Grouped broadcasts (multi-line as ONE broadcast)
\nGrouped broadcasts allow multiple lines to be linked together and sent as **one complete broadcast block**.<\/p>\n
\ud83d\udd04 Rotation happens per group, not per line.<\/p>\n
Grouped broadcasts are ideal for:
\n– \ud83d\udca1 tips with multiple lines
\n– \ud83d\udce3 announcements
\n– \ud83c\udff7\ufe0f server information blocks
\n– \ud83d\udd17 messages containing clickable links<\/p>\n
When sent, a grouped broadcast appears between one spacer line above and one spacer line below.<\/p>\n
—<\/p>\n
### \ud83c\udfa8 Colors & formatting
\nAncient-Broadcast supports both modern and classic formatting systems.<\/p>\n
\ud83e\udde9 **MiniMessage** is fully supported, including colors, gradients, formatting, and click events.<\/p>\n
\ud83c\udfa8 **Minecraft & color codes** are also supported:
\n– &0 \u2013 &9
\n– &a \u2013 &f
\n– &l **bold**
\n– &o *italic*
\n– &n underline
\n– &m strikethrough
\n– &k magic
\n– &r reset
\n– \ud83c\udf08 HEX colors using &#RRGGBB<\/p>\n
MiniMessage and & color codes can be mixed in the same message.<\/p>\n
—<\/p>\n
### \ud83d\udd17 Clickable links & websites
\nClickable links are supported using MiniMessage click events \ud83d\uddb1\ufe0f.<\/p>\n
This allows linking:
\n– \ud83c\udf0d websites
\n– \ud83d\udcac Discord invites
\n– \ud83d\uded2 web shops
\n– \ud83d\udd17 any external URL<\/p>\n
—<\/p>\n
### \ud83d\udd0a Sounds
\nEach broadcast can optionally play a sound \ud83c\udfb5.<\/p>\n
Sound features:
\n– \ud83d\udd07 enable or disable sounds per broadcast
\n– \ud83d\udd14 choose a custom sound per broadcast
\n– \ud83d\udd0a custom volume
\n– \ud83c\udf9a\ufe0f custom pitch
\n– \ud83c\udf9b\ufe0f a global default sound<\/p>\n
The default sound is also used by the **broadcast-now** command.<\/p>\n
\ud83d\udcc4 On first startup, the plugin automatically generates a `sounds.yml` file in the plugin folder.
\nThis file contains **all valid sound names** you can use in the configuration or commands.<\/p>\n
—<\/p>\n
### \ud83d\udd0c PlaceholderAPI support
\nIf **PlaceholderAPI** is installed, placeholders work automatically \ud83e\udde9.<\/p>\n
Examples:
\n– `%player_name%`
\n– `%vault_eco_balance%`<\/p>\n
Placeholders are resolved **per player**, meaning each player sees their own data \ud83d\udc64.<\/p>\n
PlaceholderAPI is optional \u2014 the plugin works perfectly without it.<\/p>\n
—<\/p>\n
### \u26a1 Performance & optimization
\nAncient-Broadcast is optimized to be fast and lag-free \ud83d\ude80:
\n– \u2699\ufe0f uses the Paper scheduler
\n– \ud83d\udeab no blocking operations
\n– \ud83e\udde0 cached message parsing
\n– \ud83d\udd0d PlaceholderAPI only used if installed and needed
\n– \ud83d\udee1\ufe0f safe sound resolution (Paper 1.21+ compatible)<\/p>\n
—<\/p>\n
## \ud83d\udce6 Requirements<\/p>\n
– \u2615 Java 21
\n– \ud83e\uddf1 Paper \/ Spigot 1.20+ (Paper recommended)
\n– \ud83e\udde9 Optional: PlaceholderAPI<\/p>\n
—<\/p>\n
## \ud83d\ude80 Installation<\/p>\n
1\ufe0f\u20e3 Download the Ancient-Broadcast jar file
\n2\ufe0f\u20e3 Place it into the server **plugins** folder
\n3\ufe0f\u20e3 Start the server once (generates config.yml and sounds.yml)
\n4\ufe0f\u20e3 Edit `plugins\/Ancient-Broadcast\/config.yml`
\n5\ufe0f\u20e3 Apply changes using `\/ab reload`
\n6\ufe0f\u20e3 Enable broadcasting globally using `\/ab toggle` <\/p>\n
\u26a0\ufe0f The plugin is **disabled by default**.<\/p>\n
—<\/p>\n
## \ud83d\udd10 Permissions<\/p>\n
All commands require OP or the following permission \ud83d\udd11:<\/p>\n
`ancientbroadcast.admin`<\/p>\n
Default: OP<\/p>\n
—<\/p>\n
## \ud83e\uddd1\u200d\ud83d\udcbb Commands (complete list with explanation)<\/p>\n
### \ud83d\udccb General
\n– `\/ab help` \u2013 \ud83d\udcd6 shows all available commands
\n– `\/ab reload` \u2013 \ud83d\udd04 reloads the configuration file
\n– `\/ab toggle` \u2013 \ud83d\udd0c global enable or disable switch
\n– `\/ab list` \u2013 \ud83d\udcc4 lists all broadcasts and their status <\/p>\n
### \ud83d\udce2 Broadcast management ### \u270f\ufe0f Message editing ### \u2b50 Grouped broadcast management ### \u23f2\ufe0f Interval & scheduler ### \ud83d\udd0a Sounds ### \ud83d\udd01 Rotation ### \ud83e\uddea Testing & instant broadcasts —<\/p>\n ## \u2699\ufe0f Configuration overview<\/p>\n The configuration file contains the following sections \ud83e\uddfe:<\/p>\n – \ud83d\udd0c Global enabled toggle Each broadcast contains: Message types: If groups are defined, message and messages are ignored.<\/p>\n —<\/p>\n ## \u2764\ufe0f Support<\/p>\n Need help, found a bug, or have a feature request? \ud83d\udee0\ufe0f Enjoy using **Ancient-Broadcast** \ud83c\udf89<\/p>\n","protected":false},"excerpt":{"rendered":" AncientBroadcast. Easy Clean and Lagg-free!<\/p>\n","protected":false},"featured_media":14130,"template":"","meta":{"_minecraft_slug":"ancient-broadcast","_minecraft_project_id":"hHmxYxQW","_minecraft_author":"mysticalcraft-ancientvipers","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":84,"_minecraft_follows":1,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"ancient-broadcast.zip","_minecraft_size_bytes":27257,"_minecraft_version_count":1,"_minecraft_updated_at":"2026-05-15T20:05:27.925254Z","_minecraft_date_created":"2025-12-18T00:07:20.528337Z","_minecraft_date_modified":"2025-12-14T06:20:23.105333Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/ancient-broadcast","_minecraft_icon_attachment_id":14130,"_minecraft_imported_at":"2026-05-31T17:49:01+00:00","_minecraft_import_hash":"459221763ecbe8a30495bfb90d87ca20","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[126,127,867,92],"mod_loader":[132],"minecraft_version":[59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-14129","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-management","mod_category-paper","mod_category-social","mod_category-utility","mod_loader-paper","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/ab add
\n– `\/ab remove
\n– `\/ab enable
\n– `\/ab disable
\n– `\/ab setmessage
\n– `\/ab addline
\n– `\/ab clearlines
\n– `\/ab addgroup
\n– `\/ab addgroupline
\n– `\/ab listgroups
\n– `\/ab setinterval
\n– `\/ab setsound
\n– `\/ab defaultsound
\n– `\/ab rotation
\n– `\/ab setmode
\n– `\/ab test
\n– `\/ab broadcastnow
\n– \ud83d\udd01 Rotation settings (enabled and mode)
\n– \ud83d\udd0a Default sound settings (enabled, sound, volume, pitch)
\n– \ud83d\udce2 Broadcast definitions <\/p>\n
\n– \u2705 enabled toggle
\n– \u23f1\ufe0f interval value and unit
\n– \ud83d\udd0a sound settings
\n– \ud83d\udcac message, messages, or groups<\/p>\n
\n– \ud83d\udfe2 `message` \u2013 single-line broadcast
\n– \ud83d\udd35 `messages` \u2013 rotating single-line broadcasts
\n– \u2b50 `groups` \u2013 rotating multi-line broadcasts sent as one block<\/p>\n
\n– \ud83d\udc1e Open an issue on **Modrinth**
\n– \ud83d\udcac Or contact the author directly <\/p>\n