![AnnouncerPlus Logo](https://i.imgur.com/C46OmJ6.png) [![Jenkins Build](https://img.shields.io/jenkins/build?jobUrl=https%3A%2F%2Fjenkins.jpenilla.xyz%2Fjob%2FAnnouncerPlus%2F&label=Jenkins%20build&style=for-the-badge)](https://jenkins.jpenilla.xyz/job/AnnouncerPlus/) ## Overview - **Custom Join and Quit Messages**, assigned by permission: - Custom join MotD messages - Custom broadcasts on player join/quit - Custom commands on player join/quit - Sounds on player join/quit - Custom Titles/Subtitles and Action/Boss Bars on player join - Custom Toast/Achievements on player join - **Automatic Messages/Broadcasts** on timers, assigned by permissions: - Randomize the order of messages - Play sounds - Show Titles - Show Boss Bars - Show Action Bars - Show custom Toast/Achievements - **Send/Broadcast Messages, Titles, Action Bars, Boss Bars, and Toasts** to worlds or players using commands. - **Animations Support** for Titles, Subtitles, Boss Bars, and Action Bars. See the [wiki page](https://github.com/jpenilla/AnnouncerPlus/wiki/Text-Animations) for more info. - **MiniMessage parsing** for all messages. - Built in gradients, hex colors, shadow colors, and more - [MiniMessage docs](https://docs.advntr.dev/minimessage/format) - [MiniMessage viewer](https://webui.advntr.dev/) [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) is a *highly recommended*, but optional dependency. You may use any PlaceholderAPI placeholders in messages. [Vault](https://dev.bukkit.org/projects/vault) is a required dependency. ## Feature Summary ### Custom Join and Quit Messages - Configs stored in `plugins/AnnouncerPlus/joinquit/` - Optional first join config (different messages, titles, commands, etc. for a player's first join) - Create multiple Join/Quit message configs and assign them by permission - Assign groups of Join/Quit configs and randomly select one on join/quit - Supports Titles, Subtitles, Action Bars, Boss Bars, Sounds, Commands, and Toasts/Achievements ![Example Join](https://i.ibb.co/3BXJXNv/ap.gif) ### Custom Broadcast Messages - Configs stored in `plugins/AnnouncerPlus/messages/` - Create multiple broadcast configs and assign them by permission - Supports Titles, Subtitles, Action Bars, Boss Bars, Sounds, Commands, and Toasts/Achievements ![Example Broadcast](https://i.imgur.com/v3jyu75.png) ### Chat Color Support - Full vanilla and hex color codes ```xml Colored text! Red Text Yellow text Red and BOLD text ||||||||||||||||||||||||| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| |||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| ``` ![Chat Color Example](https://i.imgur.com/4a5YwrL.png) ### Hover Text and Click Options - [Hover Actions](https://ci.md-5.net/job/BungeeCord/ws/chat/target/apidocs/net/md_5/bungee/api/chat/HoverEvent.Action.html) - [Click Actions](https://ci.md-5.net/job/BungeeCord/ws/chat/target/apidocs/net/md_5/bungee/api/chat/ClickEvent.Action.html) Example: ```xml Click to run!'>/spawn ``` ![Hover Click Example](https://i.imgur.com/iUmbfE9.png) ### Text Animations Documentation for Text Animations: [here](https://github.com/jpenilla/AnnouncerPlus/wiki/Text-Animations) ![Animation Example](https://i.ibb.co/cwz0dDH/brrrr2.gif) ![Another Animation Example](https://i.imgur.com/x1sQJza.gif) ### PlaceholderAPI Support - Join/Quit messages and all broadcasts parsed for [PlaceholderAPI](https://www.spigotmc.org/resources/placeholderapi.6245/) placeholders - [Available Placeholders](https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders) Example: ```xml Hello, %essentials_nickname%! You have $%vault_eco_balance_commas% ``` ![Placeholder Example](https://i.imgur.com/ClkhpqN.png) ### Syntax/Formatting - See the [Message Syntax Documentation](https://github.com/jpenilla/AnnouncerPlus/wiki/Message-Syntax) - Includes: - Centering text - Full syntax documentation ### Miscellaneous Features - Tab-complete support for commands - Support for vanish (SuperVanish, ProtocolVanish, EssentialsX Vanish, etc.) - No join/quit broadcasts for vanished players ## Permissions ### Join/Quit Messages - To assign join/quit messages to a player/group use the `announcerplus.join.configname` and `announcerplus.quit.configname` permissions - For example to assign the default included join/quit messages to everyone, give the default group the `announcerplus.join.default` and `announcerplus.quit.default` permissions. - For random Join/Quit config selection, groups of join/quit configs may be created in `main.conf` and then assigned by the `announcerplus.raindomjoin.groupname` and `announcerplus.raindomquit.groupname` permissions. There is more detail in `main.conf` - A common mistake is that players with OP will have duplicate join/quit messages. To solve this make sure to negate the permissions you don't want them to have using your permissions plugin. ### Auto-announcements - To set a player/group to receive broadcasts from a message config, use the `announcerplus.messages.configname` permission - For example to make everyone receive the demo messages, give the default group the `announcerplus.messages.demo` permission - To stop a player from receiving broadcasts while AFK use the `announcerplus.messages.configname.afk` permission - For example to make no one get the demo messages while they are AFK give the default group the `announcerplus.messages.demo.afk` permission ## Commands | Command | Permission | Description | |:---|:---|:---| | `/announcerplus reload` | `announcerplus.reload` | Reloads all config files | | `/announcerplus broadcast` | `announcerplus.broadcast` | Manually broadcast a message | | `/announcerplus send` | `announcerplus.send` | Manually send a message to players | | `/announcerplus parse` | `announcerplus.parse` | Test parsing a message | | `/announcerplus parseanimation` | `announcerplus.parseanimation` | Test parsing text with animations | | `/announcerplus list` | `announcerplus.list` | List messages of a message config | | `/announcerplus help` | *No permission required* | Display help for commands | > **Note:** Similar broadcast/send commands exist for Toasts, Titles, etc., with permissions like `announcerplus.broadcasttoast`, `announcerplus.sendtoast`, etc. ## Additional Information - Check out the [AnnouncerPlus Wiki](https://github.com/jpenilla/AnnouncerPlus/wiki) for more information - You can assign Join/Quit messages and announcements per world using [LuckPerms contexts](https://luckperms.net/wiki/Context) - Toast/Achievement messages work only in Minecraft 1.12+ - When using older servers (like 1.8.8) with ViaVersion, 1.16+ clients will still receive RGB text!

Announcer Plus