Auto broadcaster with more types! Presumably you already know what this plugin is for by looking at the title, so I won't go into more on.
This plug-in is a solution for auto broadcast messages!
There are 4 types mainly supported:
CHAT: Type that will be sent in the chat box.
BOSS_BAR: Type that will be displayed by a boss bar. support multiple lines.
ACTION_BAR: Type that will be sent to player's action-bar.
TITLE: Type that will be sent by a title.
MULTIPLE_LINE_BOSS_BAR: Type that will be displayed by multiple boss bars. (Since 1.0.2)
The plugin also supports RGB color, gradient color, rainbow gradient color scheme to make your announcements even cooler!
The plugin also supports the use of JSON text (currently available for CHAT, ACTION_BAR and TITLE type announcements).
Before using this pluginON THE BUKKIT SERVER, make sure you have installed PlaceholderAPI and ProtocolLib.
BungeeCord plugin doesn't has any dependcies. INSTALL THIS PLUGIN ONLY ON BUNGEECORD. This plug-in is open source, if you like this plugin, please give me a star♥ GitHub: https://github.com/ed-3/AdvancedAnnouncement
Commands
aa help --- show help
aa start --- start announce task
aa stop --- stop announce task
aa broadcast --- broadcast an announcement
aa display --- display an announcement to you
aa list --- list all loaded announcements
aa parse --- parse a string that contains color codes
aa reload --- reload this plugin
Permissions
aa.command.start --- command access to "aa start"
aa.command.stop --- command access to "aa stop"
aa.command.broadcast --- command access to "aa broadcast"
aa.command.display --- command access to "aa display"
aa.command.list --- command access to "aa list"
aa.command.parse --- command access to "aa parse"
aa.command.reload --- command access to "aa reload"
Announcement message placeholder The role of placeholders is to personalize the content of each announcement to meet your needs.
You can see if on
github page
Notice If your server version is lower than 1.16, then the legacy color code is recommended. Although the plugin is color compatible with a lower version (it will automatically replace the RGB color with the closest legacy color), we still do not recommend using RGB color code if the server version is lower than 1.16. Upload your translations! Translations are encouraged if you want to translate this plugin, please open an issue to upload your translation.
Rate this plugin If you think this plugin is great, don't skimp on your rating and give me a Star on GitHub as a sign of encouragement. Your encouragement is the motivition for me to update this plugin!
# use bStats to collect some information of your server # This information helps us to improve the plugin. bStats: true
# defines whether an announcement should be printed into console # ONLY CHAT TYPE AND PRE_ANNOUNCE TYPE WILL BE DISPLAYED Console-broadCast: true
# enables PlaceholderAPI support PlaceholderAPI-support: true
# pre-announce time date format date-format: yyyy-MM-dd HH:mm:ss
# random announcement used. random: true
# debug test debug: false
Code (YAML):
announcements: # announce name, DO NOT HAVE DUPLICATE NAME. chat_announce_type_example: # player who don't have this permission will not receive this announcement. # if empty or don't write this, that refers to any player can receive this announcement. permission: 'user.example_perm'
# delay to the next announcement # use parameter after a number to represent delay time. # examples: # - 60s, the delay time is 60 seconds # - 1min, the delay time is 1 minute # - 1h, the delay time is 1 hour (are you sure?) # - 1d, the delay time is 1 day (are you sure?) # - 1week, the delay time is 1 week(hey? are you serious?) # - 1month, the delay time is 1 month (hey? are you serious?) # - 1year, the delay time is 1 year (hey? are you serious?) delay: 60s
# Possible types: # CHAT: this announcement type will be sent to chat box. # ACTION_BAR: this announcement type will be sent to player's action-bar. # BOSS_BAR: this announcement type will be displayed by a boss bar. # TITLE: this announcement type will be sent through a title. # PRE_ANNOUNCE: this announcement type will be sent to players at any time that you want. type: CHAT
# Content of this announcement. # +==+==+==+==+==+==+==+==+==+==+==+==+== # RGB code supported # REQUIRES YOUR SERVER VERSION IS 1.16 OR ABOVE # # Formats: # RGB: # {#FFFFFF}RGB colored text # {#FFFFFF,&l}bolded RGB color text # {#FFFFFF,&l,&n} bolded and underlined RGB text # +==+==+==+==+==+==+==+==+==+==+==+==+== # gradient & rainbow color supported # # gradient text format: {<Color1>-><Color2>[,<arg1>,<arg2>,...]} # examples: # 1. {#04ff00->#bf0000}gradient text # 2. {#04ff00->#bf0000,&l}bolded gradient text # 3. {#04ff00->#bf0000,&l,&n} bolded and underlined gradient text # # rainbow text format: {rainbow[,<arg1>,<arg2>,...]} # examples: # 1. {rainbow}rainbow text # 2. {rainbow,&l}bolded rainbow text # 3. {rainbow,&l,&n} bolded and underlined rainbow text # +==+==+==+==+==+==+==+==+==+==+==+==+== # # Notice: # PlaceholderAPI supported. # If you enabled config 'Console-broadCast', placeholder will directly display ITS RAW TEXT # (if this placeholder must be parsed with a player.) # # If your server version is lower than 1.16, then the legacy color code is recommended. # Although the plugin is color compatible with a lower version (it will automatically replace # the RGB color with the closest legacy color), we still do not recommend using RGB color code # if the server version is lower than 1.16. # +==+==+==+==+==+==+==+==+==+==+==+==+== content: - '
{rainbow
}==============================='
- '
{#ffff00}This is an example announcement' - '
{#04ff00->#bf0000}gradient color text @[email protected] ' - '
{rainbow
}==============================='
# the action bar type example action_bar_type_example: # anyone can receive this announcement permission: ''
delay: 60s
type: ACTION_BAR
content: # 2s display, max time is 10 - '
{rainbow
}this is an action bar announcement
{stay:2
}'
# default display time: 5s - 'the next action bar'
- 'test
{stay:2
}'
boss_bar_type_example:
delay: 60s
type: BOSS_BAR
# the same as action bar type content: # Possible bar color: # PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE # Possible segment count: 6, 10, 12, 20 - '
{#4d6ea5->#a7bce5}this is an boss bar announcement{stay:2}{color:GREEN}{segment:20}' # requires placeholder expansion: Animations # command: /papi ecloud download Animations (if you enabled ecloud feature) - '
%animations_<shine start=&9 middle=&4 end=&9 normal=&b size=3>this is an auto-updated boss bar</shine>%{update:0.5}' - '&6progressing boss bar
{progress:true
}'
# sets segments to 10 # default delay sets to 5 sec # default color sets to PURPLE - '&bthe next boss bar
{segment:10
}'
# this type will display 2 boss_bars for player - - '&6&lappear with two line
{stay:5
}{progress:true
}'
- '&b&lanother line, time remains
[sec
]s
{stay:5
}{progress:true
}{update:1
}'
title_type_example:
delay: 60s
type: TITLE
# the first line is major title. # the second line is subtitle. # MUST BE TWO LINES, DO NOT WRITE THREE OR MORE LINES content: - '
{#faefae->#00ff66}Example gradient title.' - '
{rainbow
}sub title'
# CONFIGS BELOW ONLY POSSIBLE IN THIS TYPE # title fadeIn time, Unit: seconds fadeIn: 0.2
# title stay time, Unit: seconds stay: 3
# title fadeout time, Unit: seconds fadeout: 1
pre_announce_example: # delay time to next announcement delay: 60s
# defines when this announcement will send to player # time format can be defined in config.yml date: 2024-1-1 00:00
# refers to a pre-announcement type: PRE_ANNOUNCE
# defines When the time arrives, what form will this announcement be displayed. # name is the same as above, BUT NOT EQUALS 'PRE_ANNOUNCE' type. displayType: CHAT
content: - '
{rainbow
}==============================='
- ''
- '
{#bf0000->#00bfbf,&l}HAPPY NEW YEAR!' - ''
- '
{rainbow
}==============================='
# the multiple line boss bar type example # Since 1.0.2 multiple_line_boss_bar_example:
delay: 60s
# stay time # unit: second # default is 5 sec stay: 3
type: MULTIPLE_LINE_BOSS_BAR
# Placeholders below are not supported: # {stay:<double>} # {delay:<double>} content: # Possible bar color: # PINK, BLUE, RED, GREEN, YELLOW, PURPLE, WHITE # Possible segment count: 6, 10, 12, 20 - '
{#4d6ea5->#a7bce5}this is an boss bar announcement{stay:2}{color:GREEN}{segment:20}' # requires placeholder expansion: Animations # command: /papi ecloud download Animations (if you enabled ecloud feature) - '
%animations_<shine start=&9 middle=&4 end=&9 normal=&b size=3>this is an auto-updated boss bar</shine>%{update:0.5}' - '&6progressing boss bar
{progress:true
}'
# sets segments to 10 # default delay sets to 5 sec # default color sets to PURPLE - '&bthe next boss bar
{segment:10
}'
Code (YAML):
# TextComponents that will be showed into chat box. # ONLY USABLE ON CHAT TYPE ANNOUNCEMENT.
# component name, DO NOT HAVE DUPLICATE NAME. example: # the text will be shown. text: '&f
[&brun_command&f
]'
onClick: # Possible actions: # OPEN_URL: open a web url, its value must match like: https://www.bing.com # OPEN_FILE: open a file on player's local disk, its value must be an absolute path of file. # RUN_COMMAND: makes a player run command, its value should have the prefix '/' # SUGGEST_COMMAND: fill a text into player's chat box. its value can be any value. action: RUN_COMMAND
value: '/say hello! this is a example action.'
# when player's mouse cursor move to this text, what content will be shown. hover-value: |-
{#f4114a->#20d820}An example hover text. &6you can use multiple lines.
&f&l>>> &b&lClick here &e&lRun command
Image View
(
For faster to display an announcement, I used the command "/aa display". In fact this plugin can broadcast an announcement on time.)
CHAT
ACTION_BAR type
BOSS_BAR type
TITLE type
MULTIPLE_LINE_BOSS_BAR type This type has been added since the version of 1.0.2