Sueta

〔Carbon's Auto Announcer〕| Multi line | Auto Center | Placeh

1.2.0

A plugin to automatically broadcast messages on your server!

·Plugin


Information

Carbon's Announcer is a free, feature-rich plugin that's designed for effortless integration with your server to let you create beautiful, content rich automatic announcements in chat.

Development of the Pro version (here) will continue outside of Spigot and includes a full rework of the plugin with more efficient code, broader version support, and additional features.


☑️Limited broadcasts
You can have as many as 10 broadcasts.

☑️Multi-line broadcasts
Use as many lines as you would like.

☑️Automatic centering
Visually improve your broadcasts appearances by utilizing the option of automatic chat centering.

☑️Per-player toggle broadcast visibility command
Allow players to hide broadcasts for them, if they prefer them hidden.

☑️Fully customizable
You can tweak everything about the plugin to work best for your servers style and needs.

☑️Rich tab completion
Enjoy effortless writing with rich tab completion support for all commands to help guide you through them and save your time, and more!

☑️Custom color support
If you're using 1.16 or above, you can use hex values for custom colors in chat with "&#hexvalue"! Regular preset colorcodes will work as well. You can easily find hex values with Googles color picker tool: https://www.google.com/search?q=color+picker

☑️PlaceholderAPI Support
Add dynamic player specific text from plugins you love to show stats.

_________________________________________________________________________________________________________

_________________________________________________________________________________________________________

Config.yml
[/LEFT]
# CarbonsAnnouncer FREE Configuration
# Version: 1.2.0
#
# This is the FREE edition. Options marked [PRO] are included so your config
# is ready for PRO - they are read but ignored in this edition.
# Upgrade to PRO to unlock: unlimited announcements, broadcast sounds & pitch,
# per-world targeting, and per-broadcast permissions.
#
# Plugin Messages
unknown-command: "&b&lCarbons&3&lAnnouncer &8» &cUnknown command. Type &f/carbonsannouncer help &cfor help."
no-permission: "&b&lCarbons&3&lAnnouncer &8» &cYou do not have permission to do this."
reload-message: "&b&lCarbons&3&lAnnouncer &8» &aConfiguration successfully reloaded."
toggle-on-message: "&b&lCarbons&3&lAnnouncer &8» &7Broadcasts &aenabled&7."
toggle-off-message: "&b&lCarbons&3&lAnnouncer &8» &7Broadcasts &cdisabled&7."
list-header: "&b&lCarbons&3&lAnnouncer &8» &7Loaded announcements &8(&f{count}&8)&7:"
list-entry: "&8- &f{id}"
list-empty: "&b&lCarbons&3&lAnnouncer &8» &cNo announcements are configured."
send-success: "&b&lCarbons&3&lAnnouncer &8» &aSent &f{id} &ato {count} player(s)."
preview-missing: "&b&lCarbons&3&lAnnouncer &8» &cUnknown announcement &f{id}&c."
not-a-player: "&b&lCarbons&3&lAnnouncer &8» &cOnly players can use this command."

# Players with carbonsannouncer.exempt will not receive broadcasts when this is true
exempt-permission: false

# Players in this list will not see broadcasts (exact names, case-insensitive)
exempted-players:
  - exempted-player1
  - exempted-player2
  - exempted-player3

# Broadcasts will not be sent to players in these worlds
disabled-worlds:
  - disabled-world1
  - disabled-world2
  - disabled-world3

# Delay between automatic announcements (seconds)
broadcast-interval: 300

# [PRO] Default sound pitch for all broadcasts. Each announcement can override
# [PRO] this with its own 'broadcast-sound-pitch' (PRO features; ignored here).
# [PRO] broadcast-sound-pitch-all: 1.0

# Seconds to wait after server start/reload before the first automatic announcement.
# Defaults to broadcast-interval when omitted.
# broadcast-delay: 300

# Send announcements in a random order instead of config order
random: false

# PlaceholderAPI is optional. If it is installed, placeholders are parsed per player.
# https://github.com/PlaceholderAPI/PlaceholderAPI/wiki/Placeholders
#
# Announcement options:
#   enabled: true/false
#   messages: list of chat lines (& color codes, &#RRGGBB hex on 1.16+)
#   hover: list of lines shown when hovering the message
#   click: http(s) URL, /command to suggest, run:/command to run, suggest:/command
#   [PRO] world: ALL or a world name (comma-separated also works)
#   [PRO] worlds: list of world names (overrides world when set)
#   [PRO] permission: NONE or a permission node required to see this announcement
#   centered: true to auto-center lines (do not add your own padding spaces)
#   [PRO] sound: NONE, or a Bukkit sound name. 1.8 and 1.13+ names are both accepted.
#   [PRO]        Examples: ANVIL_LAND, BLOCK_ANVIL_LAND, ENTITY_PLAYER_LEVELUP
#   [PRO] broadcast-sound-pitch: pitch for this announcement's sound. Overrides
#   [PRO]        broadcast-sound-pitch-all when set. Default: 1.0
#
# FREE edition limits: a maximum of 10 enabled announcements will be loaded.
# Any enabled announcements beyond the 10th are ignored until you upgrade to PRO.
# Per-world targeting and per-broadcast permissions are PRO features; all FREE
# broadcasts go to every world and are visible to everyone. Upgrade to unlock.
announcements:
  1:
    enabled: true
    messages:
      - ""
      - "     &b&lCarbons&3&lAnnouncer"
      - "&fThis is your first message line"
      - "&fThis is your second message line"
      - "&fThis is your third message line"
      - ""
    hover:
      - "&b&lToolTips"
      - "&fFirst line!"
      - "&fSecond line!"
      - "&fThird line!"
    click: ""
    world: ALL # [PRO] Per-world broadcasts are a PRO feature. Ignored in the FREE edition.
    permission: NONE # [PRO] Per-broadcast permissions are a PRO feature. Ignored in the FREE edition.
    centered: true
    sound: NONE # [PRO] Sound playback is a PRO feature. Set a sound here after upgrading.
    broadcast-sound-pitch: 1.0 # [PRO] Pitch control is a PRO feature. Ignored in the FREE edition.

  2:
    enabled: true
    messages:
      - ""
      - "&d&lServer Information"
      - "&fAnnounce your server discord here!"
      - "&fAnnounce your server website here!"
      - "&fAnnounce your server store here &d&nhttps://www.tebex.io/"
      - ""
    hover: []
    click: "https://www.tebex.io/"
    world: ALL # [PRO] Per-world broadcasts are a PRO feature. Ignored in the FREE edition.
    permission: NONE # [PRO] Per-broadcast permissions are a PRO feature. Ignored in the FREE edition.
    centered: false
    sound: NONE # [PRO] Sound playback is a PRO feature. Ignored in the FREE edition.

  3:
    enabled: true
    messages:
      - ""
      - "&d&lDONATE ON OUR STORE"
      - "&aLine 1!"
      - "&cLine 2!"
      - "&bLine 3"
      - ""
    hover: []
    click: ""
    world: ALL # [PRO] Per-world broadcasts are a PRO feature. Ignored in the FREE edition.
    permission: NONE # [PRO] Per-broadcast permissions are a PRO feature. Ignored in the FREE edition.
    centered: false
    sound: NONE # [PRO] Sound playback is a PRO feature. Ignored in the FREE edition.

  # Example: Simple Message
  example_broadcast1:
    enabled: true
    messages:
      - "&b&lTIP &r&8➟ &fRight-Click your pickaxe for custom enchants!"
    hover: [] # Use an empty list if no hover text is desired
    click: "" # Use an empty string if no click action is desired
    world: ALL # [PRO] Per-world broadcasts are a PRO feature. Ignored in the FREE edition.
    permission: NONE # [PRO] Per-broadcast permissions are a PRO feature. Ignored in the FREE edition.
    centered: false # Use boolean 'true' or 'false', not strings
    sound: NONE # [PRO] You can specify a sound here, e.g., BLOCK_ANVIL_LAND (PRO-only)

  # Example: Multi-line message with a click action for Discord
  example_broadcast2:
    enabled: true
    messages:
      # plugin will correctly parse '%nl%' into newlines.
      - "&b&l&nJOIN OUR DISCORD&r%nl%          &f%nl%&7Talk with the community, find gang alliances,%nl%&7and enter giveaways!%nl%          &5%nl%&9&lCLICK BELOW%nl%&f&ndiscord.gg/yourdiscordserver"
    hover: [] # Empty list for no hover text
    click: "https://discord.gg/yourdiscordserver" # The URL for the click action is moved here
    world: ALL # [PRO] Per-world broadcasts are a PRO feature. Ignored in the FREE edition.
    permission: NONE # [PRO] Per-broadcast permissions are a PRO feature. Ignored in the FREE edition.
    centered: false # Use boolean 'true' or 'false', not strings
    sound: NONE # [PRO] You can specify a sound here (PRO-only)


_________________________________________________________________________________________________________

/ca help -
Shows help menu

/ca reload -
Reloads the plugins config

/ca list -
List configured announcement ids

/ca toggle [on/off] -
Toggles broadcast messages

/ca send <id> -
Send an announcement now

/ca preview <id> -
Preview an announcement

_________________________________________________________________________________________________________

carbonsannouncer.admin -
Gives full access to every permission

carbonsannouncer.reload -
Gives permission to reload plugin configuration

carbonsannouncer.list -
Gives permission to list configured announcements

carbonsannouncer.send -
Gives permission to force-send an announcement

carbonsannouncer.preview -
Gives permission to preview an announcement

carbonsannouncer.toggle -
Gives permission to toggle receiving announcements

carbonsannouncer.exempt -
Removes permission to receive announcements when exempt-permission is enabled.

_________________________________________________________________________________________________________

If you have any questions or errors please contact me via discord @ carbon9_
If you would prefer not to use Discord, you can PM me here on Spigot!

_________________________________________________________________________________________________________

Thank you! Your feedback is valued greatly.

Any support requests or bug reports in the reviews will be disregarded, instead use one of the support options mentioned above!

Similar projects

Plugin →