Ancient-Broadcast

Minecraft 版本： 1.20 1.20.1 1.20.2 1.20.3 1.20.4 1.20.5 1.20.6 1.21 1.21.1 1.21.2 1.21.3 1.21.4 1.21.5 1.21.6 1.21.7 1.21.8 1.21.9 1.21.10 1.21.11

平台： paper

标签： management social utility

? 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 message (overwrites groups and messages)
• /ab addline <id> <message> – ➕ add a rotating single-line message
• /ab clearlines <id> – ? clear rotating messages

⭐ Grouped broadcast management

• /ab addgroup <id> – ? add a new empty group
• /ab addgroupline <id> <groupIndex> <message> – ? add a line to a group (groupIndex starts at 0)
• /ab listgroups <id> – ? list all groups and line counts

⏲️ Interval & scheduler

• /ab setinterval <id> <value> <SECONDS|MINUTES|HOURS>

? Sounds

• /ab setsound <id> <on|off> [sound] [volume] [pitch]
• /ab defaultsound <on|off> [sound] [volume] [pitch]

? Rotation

• /ab rotation <on|off>
• /ab setmode <SEQUENTIAL|RANDOM>

? Testing & instant broadcasts

• /ab test <id> – ⚡ instantly sends the next broadcast
• /ab broadcastnow <message> – ? sends a one-time broadcast

⚙️ Configuration overview

The configuration file contains the following sections ?:

• ? Global enabled toggle
• ? Rotation settings (enabled and mode)
• ? Default sound settings (enabled, sound, volume, pitch)
• ? Broadcast definitions

Each broadcast contains:

• ✅ enabled toggle
• ⏱️ interval value and unit
• ? sound settings
• ? message, messages, or groups

Message types:

• ? message – single-line broadcast
• ? messages – rotating single-line broadcasts
• ⭐ groups – rotating multi-line broadcasts sent as one block

If groups are defined, message and messages are ignored.

❤️ Support

Need help, found a bug, or have a feature request? ?️

• ? Open an issue on Modrinth
• ? Or contact the author directly

Enjoy using Ancient-Broadcast ?