Getting Started

Overview

XAnnounce is the announcements & automatic-messages addon for XCore. It broadcasts cycling messages through five channels, drives a live tab-list and scoreboards, and fully customizes your join / first-join / quit messages — all with reusable display conditions, text animations and full PlaceholderAPI support.

Key highlights:

• Auto-messages — cycling BossBar, Title, ActionBar, Chat and time-based Scheduled messages
• Live tab-list & scoreboards — packet-based (Folia-safe), anti-flicker, condition-selected, refreshed live
• Reusable conditions — named AND/OR conditions usable on any message, line or join/quit variant
• Animations — %animation:name% animated text usable anywhere
• Conditional join / quit — multiple variants per event (e.g. a different welcome for VIPs)
• Web config editor — edit, validate and save the whole config from XCore's dashboard
• Folia-ready — every per-player operation runs on the player's region thread, fully localized via lang.yml

Requirements

• Paper 1.21.1+ (or Folia)
• Java 21+
• XCore 1.0.4+ installed as a plugin
• Optional: PlaceholderAPI — for placeholders in messages, conditions and animations

Installation

1. Install XCore in your server's plugins/ folder if you haven't already.
2. Place XAnnounce.jar in plugins/XCore/addons/.
3. Start the server. XAnnounce generates its files in plugins/XCore/addons/XAnnounce/.
4. Edit config.yml to define your messages, tab-list, scoreboards, conditions and join/quit messages.
5. Customize wording in lang.yml (MiniMessage format).
6. Run /xannounce reload to apply changes without a restart — or edit and save everything from the web dashboard.