Announcer Plus

Jenkins Build

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 Animations Support for more info.

- MiniMessage parsing for all messages. - Built in gradients, hex colors, shadow colors, and more - MiniMessage parsing - %%MD1%%

PlaceholderAPI is a *highly recommended*, but optional dependency. You may use any PlaceholderAPI placeholders in messages. 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

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

Chat Color Support

- Full vanilla and hex color codes

```xml <color:#ff00ff>Colored text!</color:#ff00ff> <red>Red Text <yellow>Yellow text</yellow> <bold>Red and BOLD text</red></bold> <rainbow>|||||||||||||||||||||||||</rainbow> <gradient:#00DCFF:#FFAC00>|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| <gradient:light_purple:blue>|||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||||| ```

Hover Text and Click Options

- Hover Actions - Click Actions

Example: ```xml <click:run_command:/spawn><hover:show_text:'<green><italic>Click to run!'><rainbow>/spawn</rainbow></hover></click> ```

Text Animations

Documentation for Text Animations: here

PlaceholderAPI Support

- Join/Quit messages and all broadcasts parsed for PlaceholderAPI placeholders - Available Placeholders

Example: ```xml Hello, %essentials_nickname%<reset>! You have $<green>%vault_eco_balance_commas% ```

Syntax/Formatting

- See the Message Syntax Documentation - 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 for more information - You can assign Join/Quit messages and announcements per world using LuckPerms contexts - 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!