BBAds

BBAds - Enhance Player Engagement with Dynamic BossBar Messages

BBAds is a Minecraft plugin designed to enhance player engagement by displaying dynamic information in the BossBar. This plugin offers a range of features to keep players informed and entertained, improving the overall server experience.

Key Features:

• Server Advertisements: Automatically rotates predefined messages from the config.yml file. This allows you to display important server information to all players.
• Player Advertisements: Players with the appropriate permission can display custom messages in the BossBar for a limited time.
• Administrative Control: Enable/disable server ads, mute abusive players, and reload the configuration without restarting the server.
• Mute System: Allows administrators to prevent specific players from sending messages to the BossBar.
• Curse Word Filter: Filters unwanted words and phrases using regular expressions defined in the regex.yml file.
• Logging: Records all messages sent to the BossBar in a log file for moderation and analysis purposes.

Commands:

Player Commands:

• /bb <time> <bossbar_color> <text_color> <message> - Sends a custom message to the BossBar.
  • <time>: The duration (in seconds) for which the message will be displayed.
  • <bossbar_color>: The color of the BossBar (e.g., BLUE, RED, GREEN).
  • <text_color>: The color of the message text (e.g., AQUA, YELLOW).
  • <message>: The text to display.
  • Example: /bb 10 RED YELLOW Check out my shop!

Administrator Commands:

• /bb mute <player> [time] - Mutes a player, preventing them from sending messages. If no time is specified, the mute is permanent until the player is unmuted.
• /bb unmute <player> - Unmutes a player.
• /bossbarad <on|off|stop|reload> - Server management commands.
  • on: Enables automatic server advertisements.
  • off: Disables server advertisements.
  • stop: Stops all BossBars immediately.
  • reload: Reloads settings from the config.yml and regex.yml files.

Permissions:

• bossbarads.use: Allows a player to use the /bb command.
• bossbarads.kd.15: Allows sending messages for 15 seconds.
• bossbarads.kd.30: Allows sending messages for 30 seconds.
• bossbarads.kd.60: Allows sending messages for 60 seconds.
• bossbarads.kd.120: Allows sending messages for 120 seconds.
• bossbarads.kd.unlimited: Allows sending messages with no time limit.
• bossbarads.admin: Grants access to administrator commands.

Configuration (config.yml):

enable_logging: true  # Enable or disable logging
alternate_ads: true # Alternate between player and server ads
bossbar_id: "ads" # ID of the BossBar (recommended not to change)
player_ads_interval: # Interval between player ads (in seconds)
  min: 15
  max: 60
server_ads_interval: # Interval between server ads (in seconds)
  min: 30
  max: 60
server_ads: # List of server advertisements
  - "&aJoin us, it's fun here!"
  - "&eSubscribe to our Discord!"
muted_players: # List of muted players
  player1: 0 # player1 is muted permanently (until unmuted)
player_ad_format: "§7§o%name%§r: %message%" # Format of player advertisements.
%name% - player's name
%message% - player's message

Curse Word Filter (regex.yml):

regex: # List of words and phrases to filter
  - "bad_word1"
  - "bad_word2"
  - ".website\.com." # Block websites

Installation:

1. Download the .jar file of the plugin.
2. Place the .jar file into the plugins folder of your Minecraft server.
3. Start the server.
4. Configure the config.yml and regex.yml files to your liking.

Dependencies:

• Spigot or Paper (or another server that supports Bukkit/Spigot plugins)