Bukkit

The messages that the auto broadcaster will broadcast are saved in the file called messages.txt in the plugins/broadcast map.

In this file you can add, edit and remove messages to be auto broadcasted.

Dynamic data

Dynamic data is things that can change in the server.
the dynamic data you can add to your messages are:

• %uptime-days% - shows the uptime of the server in days
• %uptime-hours% - shows the uptime of the server in hours
• %uptime-minutes% - shows the uptime of the server in minutes
• %uptime-seconds% - shows the uptime of the server in seconds
• %mobs% - shows the amount of mobs on the server
• %mobs-boss% - shows the amount of bosses on the server
• %mobs-hostile% - shows the amount of hostile mobs on the server
  • When using %mobs-hostile% and %mobs-boss% in the same message, the hostile mobs are without the bosses
• %mobs-passive% - shows the amount of passive mobs on the server
• %players% - shows the amount of players on the server

how to use

add the dynamic data words you want to have in your message on the place you want them, and when they get broadcasted, it will be replaced by the correct data.

example

The uptime of this server is: %uptime-days% days, %uptime-hours% hours, %uptime-minutes% minutes and %uptime-seconds% seconds!
There are currently %mobs% mobs on the server, of which %mobs-boss% are bosses, %mobs-hostile% are hostile mobs and %mobs-passive% are passive mobs!
The amount of players online is %players%

Questions

Why using 4 dynamic data words to get the uptime of the server, why not just use %uptime% and get the days, hours, minutes, and seconds?

• I choose to use 4 dynamic data words to get the uptime of the server because I think you should be the one that choose how you want to display the uptime of the server, not me. If i should add %uptime% there is no way for you to change the format of the uptime, and I think there should be a way to change that.

custom messages

Custom Messages are per message editable.
the things you can edit per message are:

• prefix - changes the prefix you set in the config to the prefix you set in the message
• suffix - changes the suffix you set in the config to the suffix you set in the message
• time - changes the time before the next message will be auto broadcasted
  • time can be set in minutes and seconds, use s after the time to set seconds
• permission - adds a permission to the broadcast message, only people with that permission can see the broadcast
  • the permission is: broadcast.bca.message.<permission you specify>
• world - sets the world the broadcast is visible in
  • multiple worlds can be set, seperate the worlds with: ", " (without quotes)
• option - sets options to do after the message is broadcasted
  • options supported are: reload, stop broadcast, start next after reload, start file <file name> at <line number>

how to use

The custom messages must be used in a specific format for it to work.
you can set the prefix of an message by typing: prefix="<custom prefix here>"
you can set the suffix of an message by typing: suffix="<custom suffix here>"
you can set the time for the next message by typing: time="<custom time here>"
you can set the permission of an message by typing: permission="<custom permission here>"
you can set the world an message is broadcasted in by typing: world="<world name>, <another world name>"
you can set the option of an message by typing: option="<option>"

If you want to use all custom messages, you have to make sure to use this format:
prefix="<custom prefix here>" suffix="<custom suffix here>" time="<custom time here>" <message>

If you want to use multiple custom messages, make sure that:

• the prefix must be the first thing in the message
  
• the suffix must be after the prefix
  
• the time must be after the suffix
  
• the permission must be after the time
  
• the world must be after the permission
  
• the option must be after the world
  if you would want to use a suffix, but no prefix, you must put the suffix at the beginning of the line.

default customization

The default customization is always at the top of the file. It should look like this:

[prefix="[default prefix]" suffix="[default suffix]" time="default time" permission="default permission" world="default world" option="default option"]
<first message to broadcast>

example

prefix="[custom prefix!]" suffix="now with suffix!" time="2" permission="plugin" world="world_nether" option="stop broadcast" This server is running Broadcast++! 
prefix="another prefix" time="5s" this time without a custom suffix 
suffix="[end of message]" time="0" no custom prefix this time 
prefix="just a prefix" suffix="just a suffix" no custom timing 
prefix="prefix" only custom prefix
suffix="suffix" only custom suffix 
time="8s" only custom timing

simple reload file

[prefix="[Reload Countdown]"]
time="5s" Server will reload in 10 seconds!
time="1s" Server will reload in 5 seconds!
time="1s" Server will reload in 4 seconds!
time="1s" Server will reload in 3 seconds!
time="1s" Server will reload in 2 seconds!
time="1s" Server will reload in 1 seconds!
option="start next after reload" Server is reloading now, Possibility for lag
option="stop broadcast" Server is successfully reloaded!

Questions

if you have any questions about how to use the custom messages, please make sure to first let the messages.txt file regenerate itself, by deleting or renaming the messages.txt file and starting the server. then take a look at how the messages are added there.
if you still have questions, please post them in the comments, and I will answer them.

suggestions

• no suggestions yet

If you have a suggestion to add, please post it in the comments