Easy Announcements

<center>  ![Paper 26.2](https://img.shields.io/badge/Paper-26.2-brightgreen?style… ![Minecraft 26.2](https://img.shields.io/badge/Minecraft-26.2-green?style=f… ![DiscordSRV Supported](https://img.shields.io/badge/DiscordSRV-Supported-5865F2?… ![PlaceholderAPI Supported](https://img.shields.io/badge/PlaceholderAPI-Supported-ora… ![LuckPerms Supported](https://img.shields.io/badge/LuckPerms-Supported-00C853?s… </center> <center>

Easy Announcements 2.0.0

The rewrite update </center> ---

Overview

Easy Announcements 2.0.0 is a full rewrite for Paper 26.2 on Java 25. Announcements are now driven by presets, targeting understands LuckPerms groups and permissions, announcements can run on a schedule, and there is a proper developer API for other plugins to build on. Your 1.x configs are converted automatically on first start and the originals are kept as config.v1-backup.yml and discord.v1-backup.yml. Old esa.* permissions still work. ---

Platform

* Updated to Minecraft 26.2 and the Paper 26.2 API * Now requires Java 25 (Paper 26.2 requires it) * Runs on Paper, Purpur and other Paper forks * Updated PlaceholderAPI (2.12.3) and DiscordSRV (1.30.5) integrations * Added LuckPerms (API 5.5) integration ---

Presets

A preset is a complete look: title, chat layout, action bar, boss bar, sound and Discord embed settings. * Five presets included: default, alert, restart, tip, event * Add unlimited presets, anything you leave out inherits from default * Choose one per announcement with -p <preset> * Lock a preset behind easyannouncements.preset.<name> * Give a LuckPerms group its own default preset with meta * Presets can be registered at runtime by other plugins ---

New display: action bar

* Text above the hotbar with a configurable duration * Automatically re-sent so it does not fade after two seconds * Toggle per preset like every other display ---

Text formatting

MiniMessage support everywhere*: gradients, hex colors, hover text, clickable links * Classic & codes and &#RRGGBB hex still work and can be mixed with MiniMessage in the same line * Chat announcements are now a plain list of lines, add or remove as many as you want * Message formatting by the sender is permission gated (easyannouncements.format) and can be forced on or off in the config * New messages.yml, every message the plugin sends is editable ---

Targeting

* @a all players * <player> one player * @w <world> one world `@g <group>` a LuckPerms group, inherited groups included (new)* `@p <permission>` players holding a permission (new)* `@s` yourself (new)* `group:staff` and `world:nether` inline forms (new)* * Per-selector permissions: easyannouncements.target.<name> * Optional targets.receive-permission so only certain players receive announcements * Smarter tab completion for selectors, worlds, groups, presets and flags ---

Command options

New flags that go before the message: * -p <preset> pick a preset * --silent skip the sound * --no-discord do not post to Discord * --force reach players who muted announcements * --only title,chat use only these displays * --no bossbar skip these displays ---

New commands

* /ea preview [-p preset] <message> show an announcement only to yourself * /ea presets list the presets you may use, click to insert * /ea history [count] recent announcements with time, sender and target * /ea last send the last announcement again * /ea toggle players can hide announcements for themselves * /ea schedules [run <id>] list schedules or fire one now * /ea update check Modrinth on demand * /ea version version, Minecraft version and active hooks * All commands share one root: /ea, /announce, /announcement, /esa, /easyannouncements * /esareload kept as a legacy alias ---

Scheduled announcements

* Any number of schedules, each with its own interval, preset, target and message list * Sequential or random rotation * Minimum online players before a schedule runs * Optional Discord posting per schedule * %easyannouncements_schedule_next_<id>% shows the countdown ---

Update notifications

* Checks Modrinth on startup and on a configurable interval Only reports releases that list your* Minecraft version, so you never get told about an update you cannot run * Console notice plus a clickable in-game message for anyone with easyannouncements.update when they join * Configurable join delay, prerelease opt-in, and an UpdateAvailableEvent for developers ---

LuckPerms integration

* @g <group> targeting, including inherited groups * Placeholders without PlaceholderAPI: %sender_prefix%, %sender_suffix%, %sender_group%, %player_prefix%, %player_group% * Meta keys per group or user: * easyannouncements.cooldown seconds between announcements * easyannouncements.max-length message length limit * easyannouncements.preset preset used when none is given * Offline permission checks for Discord linked accounts * Reworked permission tree: easyannouncements.announce, .admin, .target.<selector>, .preset.<name>, .format, .bypass.cooldown, .update, .discord, .toggle, .receive Legacy `esa.` nodes are mapped onto the new ones ---

PlaceholderAPI integration

* Placeholders are parsed for the receiving player in every display * Relational placeholders (%rel_...%) between sender and receiver New `%easyannouncements_%` expansion: * _last_message% _last_sender% _last_preset% _last_target% _last_count% _last_time% * _total% _presets% _preset_count% * _muted% _cooldown% * _update_available% _latest_version% _version% _hooks% * _schedule_next_<id>% ---

Discord integration (DiscordSRV)

Multiple channels*, by channel ID or DiscordSRV channel name Three modes*: embed, text and webhook * Message content above the embed, with role, user, @everyone and @here mentions * Per-preset embed color, title and channel override * Slash command with message, target and preset options, presets offered as choices * Prefix command with target: and preset: tokens, optional command message deletion * Restrict commands to specific channels Permissions by role ID, user ID, Discord administrator, or a linked Minecraft account* holding easyannouncements.discord, checked through LuckPerms even when the player is offline * Linked users announce under their Minecraft name * Sender avatars now use UUIDs, so name changes no longer break the head image * Embed fields moved to a clean list, placeholders work in field names and values * Announcements sent from Discord no longer echo back to Discord by default ---

Developer API

EasyAnnouncementsAPI api = EasyAnnouncementsProvider.get();

api.broadcast(Announcement.builder("Boss spawns in <yellow>2 minutes</yellow>")
        .source(AnnouncementSource.api("MyBossPlugin"))
        .preset("event")
        .placeholder("boss", "Ender Dragon")
        .disableDisplay("bossbar")
        .build());

* Announcement builder with preset, source, placeholders, metadata, display toggles and force delivery * AnnouncementResult with recipients, displays used and Discord status * AnnouncementDisplay register your own delivery channel (holograms, scoreboards, Bedrock forms), presets can carry your own keys through Preset#custom * TargetResolver register your own selectors such as @team or @radius * PlaceholderProvider register %your_placeholder% values with no PlaceholderAPI needed * registerPreset create presets at runtime * Events: `Announcem