Announcer Plus

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

• MiniMessage parsing for all messages.

  • Built in gradients, hex colors, shadow colors, and more
  • MiniMessage docs
  • MiniMessage viewer

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

<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:

<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:

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!