EzAnnounce

A powerful, configurable announcement plugin for Paper 1.21–1.21.1. EzAnnounce broadcasts messages to players using Action Bar, Title, Chat, or Boss Bar — with sounds, permissions, placeholders, per-announcement overrides, and full MiniMessage formatting.

---

Why EzAnnounce?

• 4 display types per announcement — Action Bar, Title (with subtitle & timing), Chat (clickable/hoverable), and Boss Bar (with color & overlay)
• Per-announcement configuration — each message can have its own display type, sound, permission, title timing, and boss-bar settings
• MiniMessage formatting — gradients, hover events, click events, HEX colors, and more
• Sequential or Random ordering
• Built-in placeholders — {online}, {max}, {time}, {date}, {motd}
• Sound effects — global and per-announcement sounds with configurable volume & pitch
• Lightweight & optimized — runs on a single scheduler task, zero overhead
• Tab completion for all commands

---

Commands

Command	Description	Permission
/ezannounce	Show help menu	Everyone
/ezannounce reload	Reload config.yml	ezannounce.reload
/ezannounce now [index]	Force-send an announcement now	ezannounce.now
/ezannounce list	List all loaded announcements	Everyone
/ezannounce info	Show plugin info + stats	Everyone

Alias: /eza

---

Permissions

Permission	Default	Description
ezannounce.reload	op	Reload the configuration file
ezannounce.now	op	Force-send an announcement
ezannounce.vip	(custom)	Receive VIP-only announcements

---

Configuration

settings:
  interval: 60            # seconds between broadcasts
  order: SEQUENTIAL       # SEQUENTIAL or RANDOM
  default-display: ACTION_BAR

sound:
  enabled: true
  sound: BLOCK_NOTE_BLOCK_PLING
  volume: 0.5
  pitch: 1.0

title-defaults:
  subtitle: ""
  fade-in: 10
  stay: 40
  fade-out: 10

boss-bar-defaults:
  color: WHITE
  overlay: PROGRESS
  duration: 5

announcements:
  - message: "<gradient:gold:red>Welcome to {online}/{max} players!</gradient>"
    display: TITLE
    subtitle: "<gray>Enjoy your stay!</gray>"
  - message: "<green>Check out our website!</green>"
    display: ACTION_BAR
    sound:
      enabled: true
      sound: ENTITY_EXPERIENCE_ORB_PICKUP
  - message: "<click:open_url:'https://example.com'><hover:show_text:'<gray>Click</gray>'><yellow>Visit our site!</yellow></hover></click>"
    display: CHAT
  - message: "<aqua>Current time: {time}</aqua>"
    display: BOSS_BAR
    boss-bar:
      color: BLUE
      overlay: NOTCHED_10
      duration: 7
  - message: "<light_purple>VIP message!</light_purple>"
    display: TITLE
    permission: "ezannounce.vip"

---

Placeholders

Placeholder	Replaced with
{online}	Current online player count
{max}	Max player slots
{time}	Current server time (HH:mm)
{date}	Current date (yyyy-MM-dd)
{motd}	Server MOTD (plain text)

---

Requirements

• Paper 1.21 – 1.21.1
• Java 21+

Installation

1. Download the JAR
2. Place it in your server's plugins/ folder
3. Restart your server
4. Edit plugins/EzAnnounce/config.yml to customize announcements
5. Run /ezannounce reload to apply changes