Перейти к содержимому
Mineforgian

CyAnnouncer

An advanced, announcer plugin for Bukkit servers, Bungeecord, and Velocity proxies.

Загрузки
237
Подписчики
1
Обновлён
27 октября 2025 г.
Лицензия
MIT

Опубликован 23 октября 2025 г.

whoimai

A simple yet powerful, multi-platform announcement plugin designed for Bukkit, BungeeCord, and Velocity.
Keep your players informed with automated, scheduled messages tailored to specific servers or worlds.

Supported Platforms

  • Bukkit/Spigot (and any forks like Paper, Purpur)
  • Bungeecord (and any forks like Waterfall)
  • Velocity

Features

  • Multi-Platform: A single codebase provides native JARs for Bukkit, BungeeCord, and Velocity.
  • Customizable Messages: Configure unlimited announcements, each with its own multi-line text.
  • Configurable Interval: Set the global time (in seconds) between each announcement.
  • Custom Prefix: Add a global prefix to all messages (supports color codes).
  • Context-Aware Targeting:
    • On Bukkit, show messages in specific worlds or globally (all).
    • On BungeeCord/Velocity, show messages on specific servers or globally (all).
  • Reload Command: Reload the configuration in-game without a server/proxies restart.

Installation

Download the correct JAR file for your server type from the Release Page. Do not install all three JARs.

For Bukkit/Spigot

  1. Download CyAnnouncerBukkit-1.0.0.jar (Use the Latest Version).
  2. Place the JAR file in your Bukkit/Spigot server's plugins/ folder.
  3. Restart your server.
  4. Change the configuration as desired in plugins/CyAnnouncerBukkit/config.yml.

For BungeeCord

  1. Download CyAnnouncerBungee-1.0.0.jar (Use the Latest Version).
  2. Place the JAR file in your Bungee proxy's plugins/ folder.
  3. Restart your proxy.
  4. Change the configuration as desired in plugins/CyAnnouncerBungee/config.yml.

For Velocity

  1. Download CyAnnouncerVelocity-1.0.0.jar (Use the Latest Version).
  2. Place the JAR file in your Velocity proxy's plugins/ folder.
  3. Restart your proxy.
  4. Change the configuration as desired in plugins/CyAnnouncerVelocity/config.yml.

Commands and Permissions

Commands are different and permissions remain the same

Bukkit/Spigot

Commands Descriptions Permissions
/announcer Display a list of commands -
/announcer reload or /an reload Reload config.yml announcer.reload
/announcer broadcast Send messages to all worlds or to specific worlds. announcer.broadcast

BungeeCord

Commands Descriptions Permissions
/bcreload Reload config.yml announcer.reload
/bcbroadcast all/server Send messages to all servers or to specific servers. announcer.broadcast

Velocity

Commands Descriptions Permissions
/announcer reload Reload config.yml announcer.reload
/vbroadcast all/server Send messages to all servers or to specific servers. announcer.broadcast

Configuration

The configuration of each platform is different

Bukkit/Spigot

/plugins/CyAnnouncerBukkit/config.yml

Default Configuration
# ===================================================================
#                  CyAnnouncer Configuration
# ===================================================================
#
# Plugin Author: cydev-id
# Plugin Version: 1.0.2
#
# HOW IT WORKS:
# This plugin will display announcements with an independent cycle for each world.
#
# 1. A world with specific messages (e.g., 'world_the_end') will have a cycle of:
#    (Global Message -> Specific End Msg 1 -> Global Message -> ...)
#
# 2. A world without specific messages will ONLY cycle through global messages.
#
# ===================================================================

# DO NOT CHANGE THIS.
config-version: 2

# Interval in SECONDS between each announcement for a world.
interval: 60

# Prefix appearing before each announcement line.
# Set to "" to disable.
prefix: "&e[&l!&r&e] &r"

# (NEW) --- SETTINGS SECTION (Feature #3) ---
settings:
  # Set to true to pick a random message from all available messages (global + specific) each cycle.
  # Set to false to use the default sequential cycle (default).
  random: false

# --- ANNOUNCEMENTS SECTION ---
announcements:
  # --- GLOBAL ANNOUNCEMENTS ---
  # These messages will be part of the cycle in ALL worlds.
  # Use "all" in the 'worlds' list.

  # Example 1: Standard CHAT message (default type)
  - worlds:
      - "all"
    lines:
      - "&eDon't forget to vote for the server every day!"
      - "&fUse the command &b/vote&f to get rewards."

  # Example 2: Global ACTIONBAR message with a SOUND (Features #2 & #5)
  - worlds:
      - "all"
    type: "ACTIONBAR" # (NEW) Type: CHAT, ACTIONBAR, or TITLE
    sound: "ENTITY_PLAYER_LEVELUP" # (NEW) Sound from Bukkit's Sound Enum
    lines:
      - "&aWelcome! Check out our store at &b/buy"
      # Note: ACTIONBAR only uses the first line.

  # --- WORLD-SPECIFIC ANNOUNCEMENTS ---
  # These messages will ONLY appear in the specified worlds.

  # Example 3: TITLE message for a specific world (Feature #2)
  - worlds:
      - "world_the_end"
    type: "TITLE"
    lines:
      - "&5Welcome to The End!" # Line 1 is the main TITLE
      - "&7Be careful of the Dragon!" # Line 2 is the SUBTITLE

  - worlds:
      - "world_nether"
    lines:
      - "&cIt's hot in here! Make sure to bring fire resistance potions."
      - "&fDon't hit a Piglin without preparation!"

BungeeCord

/plugins/CyAnnouncerBungee/config.yml

Default Configuration
# ===================================================================
#                 CyAnnouncerBungee Configuration
# ===================================================================
#
# Plugin Author: cydev-id
# Plugin Version: 1.0.2
#
# HOW IT WORKS:
# This plugin will display announcements with an independent cycle for each server.
#
# ===================================================================

# DO NOT CHANGE THIS.
config-version: 2

# Default interval in SECONDS between each announcement for a server.
interval: 60

# The prefix that appears before every line of an announcement.
# Set to "" (empty quotes) to disable the prefix entirely.
prefix: "&e[&l!&r&e] &r"

# (NEW) --- SETTINGS SECTION (Feature #3) ---
settings:
  # Set to true to pick a random message from all available messages (global + specific) each cycle.
  # Set to false to use the default sequential cycle (default).
  random: false

# --- ANNOUNCEMENTS SECTION ---
announcements:
  # --- GLOBAL ANNOUNCEMENTS ---
  # To make a message global, add "all" to its 'servers' list.

  # Example 1: Standard CHAT message (default type)
  - servers:
      - "all"
    lines:
      - "&eDon't forget to vote for the server every day!"
      - "&fUse the command &b/vote&f to get rewards."

  # Example 2: Global ACTIONBAR message (Feature #2)
  - servers:
      - "all"
    type: "ACTIONBAR" # (NEW) Type: CHAT, ACTIONBAR, or TITLE
    # sound: "..." # (Note: Sound is NOT supported on BungeeCord)
    lines:
      - "&aWelcome! You are on server &e%server_name%&a!"
      # Note: ACTIONBAR only uses the first line.

  # --- SERVER-SPECIFIC ANNOUNCEMENTS ---
  # These messages will ONLY be shown to players on the specified servers.

  # Example 3: TITLE message for a specific server (Feature #2)
  - servers:
      - "lobby"
    type: "TITLE"
    lines:
      - "&bWelcome to the Lobby!" # Line 1 is the main TITLE
      - "&7Check out the new gadgets!" # Line 2 is the SUBTITLE

  # Example 4: Original Survival message
  - servers:
      - "survival"
    lines:
      - "&cWatch out! This is a PvP-enabled server."

Velocity

/plugins/CyAnnouncerVelocity/config.yml

Default Configuration
# ===================================================================
#                 CyAnnouncerVelocity Configuration
# ===================================================================
#
# Plugin Author: cydev-id
# Plugin Version: 1.0.2
#
# HOW TO USE THIS FILE:
#
# - Use the '&' symbol for color codes (e.g., &a for green, &l for bold).
# - YAML is sensitive to spacing. Do not use tabs; use spaces.
#   Indentation is crucial for the structure.
#
# ===================================================================

# Default interval in SECONDS between each announcement for a server.
# For example, if a player is on the Survival server, they will see a
# new message from their announcement cycle every 60 seconds.
interval: 60

# The prefix that appears before every line of an announcement.
# Set to "" (empty quotes) to disable the prefix entirely.
prefix: "&e[&l!&r&e] &r"

# (NEW) --- SETTINGS SECTION (Feature #3) ---
settings:
  # Set to true to pick a random message from all available messages (global + specific) each cycle.
  # Set to false to use the default sequential cycle (default).
  random: false


# ===================================================================
#                     ANNOUNCEMENTS SECTION
# ===================================================================
#
# HOW IT WORKS:
# This plugin uses an intelligent, independent cycle system for each server.
#
# 1.  A server with its own specific messages (e.g., 'survival') will create a
#     unique cycle: (Global Message -> Specific Survival Msg 1 -> Specific Survival Msg 2 -> Global Message -> ...)
#
# 2.  A server WITHOUT specific messages (e.g., 'lobby') will only cycle
#     through the global messages: (Global Message 1 -> Global Message 2 -> Global Message 1 -> ...)
#
# Each server's cycle runs independently and does not affect the others.
#
announcements:
  # --- GLOBAL ANNOUNCEMENTS ---
  # These messages will be part of the cycle for EVERY server.
  # To make a message global, add "all" to its 'servers' list.

  # Example 1: Standard CHAT message (default)
  - servers:
      - "all"
    lines:
      - "&eDon't forget to vote for our server every day!"
      - "&fUse the command &b/vote&f to get rewards."

  # Example 2: Global ACTIONBAR message with a SOUND (Features #2 & #5)
  - servers:
      - "all"
    type: "ACTIONBAR" # (NEW) Type: CHAT, ACTIONBAR, or TITLE
    sound: "entity.player.levelup" # (NEW) Sound (use Minecraft key, e.g., 'block.note_block.pling')
    lines:
      - "&dCheck out our webstore for exclusive ranks and items!"
      # Note: ACTIONBAR only uses the first line.

  # --- SERVER-SPECIFIC ANNOUNCEMENTS ---
  # These messages will ONLY be shown to players on the specified servers.
  # They will be inserted into the cycle after a global message.

  # Example 3: TITLE message for Skyblock/Oneblock (Feature #2)
  - servers:
      - "oneblock"
      - "skyblock" # You can target multiple servers with the same message block.
    type: "TITLE"
    lines:
      - "&aWelcome to the Sky!" # Line 1 is the main TITLE
      - "&fType &b/is&f to start your adventure." # Line 2 is the SUBTITLE

  - servers:
      - "oneblock"
      - "skyblock"
    lines:
      - "&bLooking for a team? Use &a/team&b to cooperate with others!"

  # Example 4: Standard CHAT message for Survival
  - servers:
      - "survival"
    lines:
      - "&cWatch out! PvP is enabled in the wilderness."
      - "&fClaim your land using a Golden Shovel to stay safe."

License

This project is licensed under the MIT

Ченджлог

1.0.2Релиз1.21.8, 1.21.9, 1.21.10 · 27 октября 2025 г.

Update 1.0.2

New Update for Velocity Version

  • New Message Types: You can now set a type: for each message.
    • type: "CHAT" - The default chat message.
    • type: "ACTIONBAR" - Displays the message above the player's hotbar.
    • type: "TITLE" - Displays a large title and subtitle on the player's screen.
  • Randomized Messages: A new settings.random: true option in your config.yml will now pick a random message from the available pool instead of cycling them in order.
  • Sound Effects: You can now add a sound: "ENTITY_PLAYER_LEVELUP" line to any announcement to play a sound for the player.

Full Changelog: https://github.com/CYDEV-ID/CyAnnouncer/compare/1.0.0...1.0.2

1.0.2Релиз1.21.8, 1.21.9, 1.21.10 · 27 октября 2025 г.

Update 1.0.2

New Update for Bungeecord Version

  • New Message Types: You can now set a type: for each message.
    • type: "CHAT" - The default chat message.
    • type: "ACTIONBAR" - Displays the message above the player's hotbar.
    • type: "TITLE" - Displays a large title and subtitle on the player's screen.
  • Randomized Messages: A new settings.random: true option in your config.yml will now pick a random message from the available pool instead of cycling them in order.
  • Sound Effect (Not Available)

Full Changelog: https://github.com/CYDEV-ID/CyAnnouncer/compare/1.0.0...1.0.2

1.0.2Релиз1.21.8, 1.21.9, 1.21.10 · 27 октября 2025 г.

Update 1.0.2

New Update for Bukkit/Spigot Version

  • New Message Types: You can now set a type: for each message.
    • type: "CHAT" - The default chat message.
    • type: "ACTIONBAR" - Displays the message above the player's hotbar.
    • type: "TITLE" - Displays a large title and subtitle on the player's screen.
  • Randomized Messages: A new settings.random: true option in your config.yml will now pick a random message from the available pool instead of cycling them in order.
  • Sound Effects: You can now add a sound: "ENTITY_PLAYER_LEVELUP" line to any announcement to play a sound for the player.

Full Changelog: https://github.com/CYDEV-ID/CyAnnouncer/compare/1.0.0...1.0.2

1.0.1Релиз1.21.8, 1.21.9, 1.21.10 · 24 октября 2025 г.

Update 1.0.1

New Update for Bungeecord Version

Since PAPI is not available in proxies, we've created our own internal placeholder system for the BungeeCord and Velocity modules! This brings much-needed dynamic functionality to your network.

Available Placeholders:

  • %player_name% - Displays the player's name.
  • %server_name% - Displays the server name the player is currently online on.
  • %proxy_online% - Displays the total number of players across all proxies.
  • %server_online% - Displays the total number of players on the specific server the player is on.
  • %ping% - Displays the player's ping.

Full Changelog: https://github.com/CYDEV-ID/CyAnnouncer/commits/build

1.0.1Релиз1.21.8, 1.21.9, 1.21.10 · 24 октября 2025 г.

Update 1.0.1

New Update for Velocity Version

Since PAPI is not available in proxies, we've created our own internal placeholder system for the BungeeCord and Velocity modules! This brings much-needed dynamic functionality to your network.

Available Placeholders:

  • %player_name% - Displays the player's name.
  • %server_name% - Displays the server name the player is currently online on.
  • %proxy_online% - Displays the total number of players across all proxies.
  • %server_online% - Displays the total number of players on the specific server the player is on.
  • %ping% - Displays the player's ping.

Full Changelog: https://github.com/CYDEV-ID/CyAnnouncer/commits/build

1.0.1Релиз1.21.8, 1.21.9, 1.21.10 · 24 октября 2025 г.

Update 1.0.1

New Update for Bukkit/Spigot Version

CyAnnouncer has hooked into PlaceholderAPI

Full Changelog: https://github.com/CYDEV-ID/CyAnnouncer/commits/build

1.0.0Релиз1.21.8, 1.21.9, 1.21.10 · 23 октября 2025 г.
1.0.0Релиз1.21.8, 1.21.9, 1.21.10 · 23 октября 2025 г.

Комментарии

Загружаем…