![WorstBroadcaster [BETA] icon](https://images.polymart.org/product/2967/thumbnail.png?t=1&v=3)
WorstBroadcaster [BETA] 0.3.1-BETA
A simple and easy-to use broadcaster plug-in.
——— PLUGIN IN BETA! ———
WorstBroadcaster is a simple and easy-to-use
broadcast plug-in which gives you the opportunity to send
messages to players in various ways and conditions.
broadcast plug-in which gives you the opportunity to send
messages to players in various ways and conditions.
Features
WorstBroadcaster provides several features and many commands, each one different from the other and with unique ways to send messages starting from the simplest to the most complex.
-
Send broadcasts in many different ways:
-
To all online players;
-
To players within a radius;
-
To all players in a WorldGuard region;
-
To all players in a world, or more;
-
To all players who have the required permission(s);
-
To specified players;
-
Send a pre-made broadcast (requirements can be set);
-
Periodically send a list of broadcasts (requirements can be set).
-
- Fully customizable and easy-to-use
- Send broadcasts as a title (
!title!
) or in action bar (!actionbar!
) - Send broadcasts with date-related requirements
- Send messages with permission-related requirements
- Use color codes (
&0
) everywhere - Hex colors (
�
) and gradients (!#000000>! !#ffffff<!
) supported - New features coming soon!
config.yml
##############################################
# #
# WorstBroadcaster Configuration #
# Plugin developed by Ceduz19 #
# #
##############################################
#Wiki: https://worstplugins.gitbook.io/worstbroadcaster/
#All color codes are supported: &f, &0, &b.
#To use a hex color follow this format: �
#To make a gradient follow this format: !#000000>!GRADIENT!#ffffff<!
#To send an actionbar or title message put !actionbar! or !title! at the beginning of the message.
pre-made-broadcasts: []
### The ID of the broadcast (each ID must be different from the others - IDs are case-sensitive).
#example:
### Set the broadcast message which will be sent (can use !actionbar! or !title! to send correspondingly an actionbar
# or a title message).
# message:
# - "&7------"
# - "&bThis is an example of a"
# - "&dPre-made Broadcast&b!"
# - ""
# - "&7&oMade by %author%."
# - "&7------"
## Regex:Replacement feature explanation:
# When using the pre-made broadcast command you can replace particular words (or characters) with others.
# This gives the opportunity to make 'custom placeholders' that can be replaced, using regular expressions (regex),
# with a word or a sentence depending on the situation.
# ————
# In the message above we can replace, for example, %author% to be the actual name of who is sending the broadcast.
# To do this we have to do the following command: /wb bcpremade example %author%:Ceduz19
# Doing that the broadcast sent will display 'Ceduz19' instead of '%author%'.
# ————
# You can do more than 1 replacement at time (/wb bcpremade <ID> [regex1:replacement1] [regex2:replacement2] ...), indeed
# it is possible to make various regex-replacements, there is no limit.
# To make more complex replacements you can use regular expressions which are very useful (tutorials on how to use them
# can be found on the internet).
#
### The message will be sent to the players who have at least one of these permissions.
# permissions:
# - "example.permission"
### Specify in which worlds the broadcast can be received.
# worlds:
# - "exampleWorld"
### Specify which player can receive the broadcast.
# players:
# - "Ceduz19"
auto-broadcaster:
#Wheter or not the Auto-Broadcaster is active.
enabled: false
#Wheter or not the broadcasts will be sent randomly.
random: false
#How many seconds have to pass until another broadcast is sent.
period: 60
broadcasts: []
#### The ID of the broadcast (each ID must be different from the others - IDs are case-sensitive).
#example:
# message:
# - ""
# - "&bThis is an example of an automatic broadcast."
# - ""
#### Section dedicated to all date-related requirements of the broadcast in order to be sent.
# date:
#
#### The 3 following options are generic time requirements useful if is needed a broadcast sent in a specific
#### week/day of the month/year instead of specifying each day.
#
### Specify in which week of the year the broadcast can be sent.
# week-of-year: <number>
#
### Specify in which week of the month (1-5) the broadcast can be sent.
# week-of-month: <number>
#
### Specify in which day of the year (1-365) the broadcast can be sent.
# day-of-year: <number>
#
### Specify in which day of the week (1-7) the broadcast can be sent.
# day-of-week: <number>
#
#### The 5 following options are more specific and permit to send the broadcast only in a specific year, month, day,
#### hour or minute (if you set all of these options the broadcast will be sent only in a specific date at a specific hour).
#
### Specify in which year the broadcast can be sent.
# year: <number>
#
### Specify in which month (1-12) the broadcast can be sent.
# month: <number>
#
### Specify in which day (1-31) the broadcast can be sent.
# day: <number>
#
### Specify in which hour (0-23) the broadcast can be sent.
# hour: <number>
#
### Specify in which minute (0-59) the broadcast can be sent.
# minute: <number>
#
### The message will be sent to the players who have at least one of these permissions.
# permissions:
# - "example.permission"
### Specify in which worlds the broadcast can be received.
# worlds:
# - "exampleWorld"
### Specify which player can receive the broadcast.
# players:
# - "Ceduz19"
messages.yml
#All values can be a string or a list.
#All placeholders are supported, except PlaceholderAPI ones.
#All color codes are supported: &f, &0, &b.
#To use a hex color follow this format: �
#To make a gradient follow this format: !#000000>!GRADIENT!#ffffff<!
commands:
auto-broadcaster:
enabled: "&aAuto-broadcaster enabled!"
disabled: "&cAuto-broadcaster disabled!"
broadcast-to-player:
#Placeholder available:
# %number% - Return the amount of players who have received the broadcast.
sent: "&aSuccessfully sent message to %number% players!"
help:
page:
- "&7&m--------&6 WorstBroadcaster Help Page &7&m--------"
- "&e/wb help &7- &fSee this page."
- "!perm:worstbroadcaster.reload!&e/wb reload &7- &fReload plugin configuration and messages."
- "!perm:worstbroadcaster.autobroadcaster.toggle!&e/wb autobroadcaster toggle &7- &fEnable or disable the auto-broadcaster."
- "!perm:worstbroadcaster.broadcast!&e/wb broadcast <message> &7- &fSend a message to all online players."
- "!perm:worstbroadcaster.broadcast.inradius!&e/wb broadcastinradius <world> <centerX,Y,Z> <radius> <message> &7- &fSend a message to all players within the specified radius."
- "!perm:worstbroadcaster.broadcast.inregion!&e/wb broadcastinregion <world> <region> <message> &7- &fSend a message to all players in the specified region."
- "!perm:worstbroadcaster.broadcast.inworld!&e/wb broadcastinworld <world1,world2,...> <message> &7- &fSend a message to all players in the specified world(s)."
- "!perm:worstbroadcaster.broadcast.perm!&e/wb broadcastperm <perm1,perm2,...> <message> &7- &fSend a message to all players with the specified permission(s)."
- "!perm:worstbroadcaster.broadcast.premade!&e/wb broadcastpremade <ID> [regex:replacement] &7- &fSend a pre-made message with the possibility to replace words using regular expressions."
- "!perm:worstbroadcaster.broadcast.toplayer!&e/wb broadcasttoplayer <player1,player2,...> <message> &7- &fSend a message to the specified player(s)."
- "&7&m----------------------------"
reload:
#Placeholder available:
# %time% - Return the milliseconds elapsed to reload the config.
reloaded-config: "&aSuccessfully reloaded plugin configuration (%time%ms)."
reloaded-locale: "&aSuccessfully reloaded messages configuration (%time%ms)."
errors:
no-perm: "&cYou do not have the permission to do that!"
no-message: "&cThe pre-made broadcast specified has no message set!"
unavailable-feature: "&cYou can't use this feature!"
#Placeholder available:
# %usage% - Return the correct usage of the command.
invalid-usage: "&cInvalid command usage! &6Use: &e%usage%"
#Placeholder available:
# %number% - Return the incorrect number written.
invalid-number: "&c%number% is not a valid number! You must use one which is higher than 0!"
#Placeholder available:
# %world% - Return the nonexistent world's name.
invalid-world: "&cThere is no world with the name %world%!"
#Placeholder available:
# %world% - Return the name of the world written.
# %region% - Return the nonexistent region's name of the specified world.
invalid-region: "&cThere is no region named %region% in world %world%!"
#Placeholder available:
# %id% - Return the nonexistent ID written.
invalid-id: "&cThere is no pre-made broadcast with the ID %id%!"
Check the wiki for a detailed guide of the plug-in!