StrippedBroadcast

**StrippedBroadcast** is a recreation of the (https://www.spigotmc.org/resources/rawmsg.35864/). <br> The main purpose of the Plugin is to send a message in chat just like the command broadcast. However, when sent, the message will **not** dispose of a **prefix** and the sender can specify a **group** of **players** to send the message to. It also has an **API** available for any developer to be used. ## Commands The main and only command of StrippedBroadcast is, you guessed it, **/sbc** (short for **/simplebroadcast**). Its syntax is: <br> ```/sbc <targets> <message>``` ​<br> As explained by the Plugin itself when trying to execute the command, the first argument should represent the targets of the broadcast. These could be: - **all**, for every player online on the server; - **<player>** or **player=<player>**, the only user who will see the message; - **me**, an alias for the command issuer; - **world=<world>**, for every player present in that world; perm=<permission>, for any player who has the permission; - **op** or **perm=op**, for every op player in the server; - **group=<group>**; StrippedBroadcast is compatible with **LuckPerms**, so the argument "group" will allow the user to specify a certain group of players; - **item=<item>**; for every player who has that item in the server; - **effect=<effect>**; for every player who the specified effect; - **gamemode=<gamemode>**; for every player in that gamemode; - **money=<money>**; for every player that has that amount of money. ## Expressions StrippedBroadcast is also able to understand **expressions** as target. The user will be able to specify certain **conditions** that will return a list of compatible players. <br> Every expression should be expressed in parenthesis, but there is possibility to put more parenthesis inside one. <br> Example: <br> ```/sbc (world=world_the_nether && (perm=bukkit.* || perm=minecraft.*)) Looks like you are the king of hell!``` ​<br> You will also notice that expressions accept the keywords AND (&&) and OR (||). Their functioning is really simple: - in the above example, the OR keyword is used to get every player who has the permission "bukkit.\*" **or** the permission "minecraft.\*"; - the AND keyword is then used to get every player who is in the nether **and** has one of the two permissions. Also, the plugin uses Tab Completition, so it will be very helpful at remembering the user to close parenthesis or insert certain keywords. ## Permissions The only permission for StrippedBroadcast is "**sbc.main**", which will allow the user to execute the /sbc command. ## Colors Since the Minecraft 1.16 update, **Hex Colors** were added to the game. Now, StrippedBroadcast is able not only to use the default Minecraft colors ("&"), but also custom ones using the character #. If you are on 1.16 or higher, when typing "#", the plugin will suggest all the valid letters and numbers to be used as color codes. Also, there is a new rainbow effect available. To use it, just type in front of your message. Example: <br> ```/sbc all StrippedBroadcast v1.2 is an amazing plugin!``` ## BungeeCord Recently a version of StrippedBroadcast compatible with BungeeCord was released. It uses the same functionalities as the Spigot one, however some argument do change: - **all**, for every player online in the server; - a **player**, the only user who will see the message; - a server ("**server=<server>**"), for every player present in that server; - a **permission** ("**perm=<permission>**"), for any player who has the permission; - a **group** ("**group=<group>**"), for any player who is in that group (REQUIRES LUCKPERMS). An API is available also for BungeeCord, that uses the same names as the Spigot API followed by a "B" (e.g. **PlayerUtilsB** is the **PlayerUtils** for the BungeeCord part of the Plugin). The Main Class is accessible by the name **StrippedBroadcastBungee** and it contains all of the methods to send a message to a list of players. ## API I honestly have no idea of how this Plugin API could be implemented, but I'm very curious to see what the developers will be able to create. Anyway, after importing the Plugin into your project, you are ready to begin. Two classes will be of your interest: ### StrippedBroadcast The class StrippedBroadcast contains the static method sendStrippedBroadcast. This will send the given message (it can be a string, a list of strings or even an array) to the list of players specified. An example is: ```java String strings = new String{"This", "is", "a", "cool", "message"}; StrippedBroadcastEvent.sendStrippedBroadcast(Bukkit.getOnlinePlayers(), strings); ``` ### StrippedBroadcastEvent and StrippedBroadcastEventB The StrippedBroadcastEvent and StrippedBroadcastEventB are events called anytime a message is sent using the Plugin Command or the Methods. They contain two variables: a list of involved players and the message sent. ```java @EventHandler public void onMe