zMAnnounce

🌟 zMAnnounce is an optimized plugin for Velocity servers that allows sending global and server-specific announcements, displaying bossbars with countdowns, and fully customizing messages with Legacy, HEX, or MiniMessage colors. It includes spam protection, message limits, and performance optimizations with color caching. 🚀

✨ Key Features

• 📢 Global & server-specific announcements
• ⏱️ Bossbars with customizable timers
• 🎨 Full color & MiniMessage support
• 🔒 Security: message limits, input validation, and anti-spam
• ⚡ Performance optimizations with thread-safe operations
• 🔔 Update notifications via Modrinth

📦 Installation

1. Download the latest release from the Modrinth page or GitHub releases
2. Place zMAnnounce-1.0.0.jar in your Velocity plugins/ directory
3. Restart your Velocity server
4. Configure the plugin in plugins/zMAnnounce/config.yml

Requirements

• Java 21+
• Velocity 3.4.0+
• Compatible Minecraft versions supported by Velocity

⚙️ Configuration

After first startup, a config.yml file is generated in plugins/zMAnnounce/.

Example snippet:

announce-template:
  sound: "BLOCK_NOTE_BLOCK_PLING"
  title:
    enabled: true
    fadein: 10
    stay: 70
    fadeout: 20
    title: "&#FFC930&lANNOUNCEMENTS"
    subtitle: "&fCheck the chat!"

Supports legacy colors, HEX, and MiniMessage formatting.

📝 Commands

Command	Description	Permission
`/zmannounce alert <server	all>`	Send an announcement	zmannounce.use
`/zmannounce bossbar <server	all>`	Start a bossbar countdown	zmannounce.bossbar
/zmannounce reload	Reload configuration	zmannounce.reload

Time format examples: 10s, 15m, 1h.

Example usage:

/zmannounce alert "Server restart in 5 minutes!" all
/zmannounce alert "Welcome to the lobby!" lobby
/zmannounce bossbar "Event starting soon!" 5m all
/zmannounce reload

🔐 Permissions

• zmannounce.use – Use alert commands (Default: OP)
• zmannounce.bossbar – Use bossbar commands (Default: OP)
• zmannounce.reload – Reload configuration (Default: OP)

🔄 Update Checker

• ✅ Checks Modrinth API for new versions on startup
• 🛎️ Optional player notifications when they join
• ⚙️ Can be disabled in config.yml

📞 Support

• Discord: Support the discord