一款简单而强大的跨平台公告插件,专为 Bukkit、BungeeCord 和 Velocity 设计。
通过针对特定服务器或世界的自动化定时消息,让您的玩家随时了解最新动态。
支持的平台
- Bukkit/Spigot(以及任何衍生版如 Paper、Purpur)
- Bungeecord(以及任何衍生版如 Waterfall)
- Velocity
功能特性
- 跨平台支持:单一代码库为 Bukkit、BungeeCord 和 Velocity 提供原生 JAR 包。
- 可自定义消息:配置无限数量的公告,每条公告均可包含多行文本。
- 可配置的间隔时间:设置全局公告之间的间隔时间(以秒为单位)。
- 自定义前缀:为所有消息添加全局前缀(支持颜色代码)。
- 上下文感知目标定位:
- 在 Bukkit 上,可在特定世界或全局(all)显示消息。
- 在 BungeeCord/Velocity 上,可在特定服务器或全局(all)显示消息。
- 重载命令:无需重启服务器/代理即可在游戏中重载配置。
安装
从 发布页面 下载适合您服务器类型的正确 JAR 文件。请勿同时安装三个 JAR 包。
适用于 Bukkit/Spigot
- 下载
CyAnnouncerBukkit-1.0.0.jar(请使用最新版本)。
- 将 JAR 文件放入您的 Bukkit/Spigot 服务器的
plugins/ 文件夹中。
- 重启服务器。
- 在
plugins/CyAnnouncerBukkit/config.yml 中根据需要更改配置。
适用于 BungeeCord
- 下载
CyAnnouncerBungee-1.0.0.jar(请使用最新版本)。
- 将 JAR 文件放入您的 Bungee 代理的
plugins/ 文件夹中。
- 重启代理。
- 在
plugins/CyAnnouncerBungee/config.yml 中根据需要更改配置。
适用于 Velocity
- 下载
CyAnnouncerVelocity-1.0.0.jar(请使用最新版本)。
- 将 JAR 文件放入您的 Velocity 代理的
plugins/ 文件夹中。
- 重启代理。
- 在
plugins/CyAnnouncerVelocity/config.yml 中根据需要更改配置。
命令与权限
命令各不相同,但权限保持一致。
Bukkit/Spigot
| 命令 |
描述 |
权限 |
/announcer |
显示命令列表 |
- |
/announcer reload 或 /an reload |
重载 config.yml |
announcer.reload |
/announcer broadcast |
向所有世界或特定世界发送消息。 |
announcer.broadcast |
BungeeCord
| 命令 |
描述 |
权限 |
/bcreload |
重载 config.yml |
announcer.reload |
/bcbroadcast all/server |
向所有服务器或特定服务器发送消息。 |
announcer.broadcast |
Velocity
| 命令 |
描述 |
权限 |
/announcer reload |
重载 config.yml |
announcer.reload |
/vbroadcast all/server |
向所有服务器或特定服务器发送消息。 |
announcer.broadcast |
配置
各平台的配置有所不同。
Bukkit/Spigot
/plugins/CyAnnouncerBukkit/config.yml
默认配置
# ===================================================================
# CyAnnouncer 配置
# ===================================================================
#
# 插件作者: cydev-id
# 插件版本: 1.0.2
#
# 工作原理:
# 此插件将为每个世界独立循环显示公告。
#
# 1. 具有特定消息的世界(例如 'world_the_end')将遵循以下循环:
# (全局消息 -> 特定末地消息 1 -> 全局消息 -> ...)
#
# 2. 没有特定消息的世界将仅循环播放全局消息。
#
# ===================================================================
# 请勿修改此项。
config-version: 2
# 每个世界每次公告之间的间隔时间(秒)。
interval: 60
# 每行公告出现前的前缀。
# 设置为 "" 以禁用。
prefix: "&e[&l!&r&e] &r"
# (新增)--- 设置部分(功能 #3)---
settings:
# 设置为 true 以在每个循环周期从所有可用消息(全局 + 特定)中随机选择一条消息。
# 设置为 false 以使用默认的顺序循环(默认值)。
random: false
# --- 公告部分 ---
announcements:
# --- 全局公告 ---
# 这些消息将成为所有世界中循环的一部分。
# 在 'worlds' 列表中使用 "all"。
# 示例 1:标准聊天消息(默认类型)
- worlds:
- "all"
lines:
- "&e别忘了每天为我们投票!"
- "&f使用命令 &b/vote&f 获取奖励。"
# 示例 2:带有音效的全局动作栏消息(功能 #2 和 #5)
- worlds:
- "all"
type: "ACTIONBAR" # (新增)类型:CHAT, ACTIONBAR 或 TITLE
sound: "ENTITY_PLAYER_LEVELUP" # (新增)来自 Bukkit Sound Enum 的声音
lines:
- "&a欢迎!查看我们的商店 &b/buy"
# 注意:ACTIONBAR 仅使用第一行。
# --- 世界特定公告 ---
# 这些消息仅会在指定的世界中显示。
# 示例 3:特定世界的标题消息(特性 #2)
- worlds:
- "world_the_end"
type: "TITLE"
lines:
- "&5欢迎来到末地!" # 第 1 行是主标题 (TITLE)
- "&7小心末影龙!" # 第 2 行是副标题 (SUBTITLE)
- worlds:
- "world_nether"
lines:
- "&c这里很热!记得带上抗火药水。"
- "&f不要在没有准备的情况下攻击猪灵!"
BungeeCord
/plugins/CyAnnouncerBungee/config.yml
默认配置
# ===================================================================
# CyAnnouncerBungee 配置
# ===================================================================
#
# 插件作者: cydev-id
# 插件版本: 1.0.2
#
# 工作原理:
# 此插件将为每个服务器显示具有独立循环的公告。
#
# ===================================================================
# 请勿更改此项。
config-version: 2
# 每个服务器每次公告之间的默认间隔时间(秒)。
interval: 60
# 出现在每行公告前的前缀。
# 设置为 ""(空引号)以完全禁用前缀。
prefix: "&e[&l!&r&e] &r"
# (新增)--- 设置部分(特性 #3)---
settings:
# 设置为 true,以便在每个循环中从所有可用消息(全局 + 特定)中随机选择一条。
# 设置为 false 以使用默认的按顺序循环(默认值)。
random: false
# --- 公告部分 ---
announcements:
# --- 全局公告 ---
# 要使某条消息成为全局消息,请将其添加到 'servers' 列表中并包含 "all"。
# 示例 1:标准聊天消息(默认类型)
- servers:
- "all"
lines:
- "&e别忘了每天为服务器投票!"
- "&f使用命令 &b/vote&f 获取奖励。"
# 示例 2:全局动作栏消息(特性 #2)
- servers:
- "all"
type: "ACTIONBAR" # (新增)类型:CHAT、ACTIONBAR 或 TITLE
# sound: "..." # (注意:BungeeCord 不支持声音)
lines:
- "&a欢迎!你正在访问服务器 &e%server_name%&a!"
# 注意:ACTIONBAR 仅使用第一行。
# --- 服务器特定公告 ---
# 这些消息将仅向指定服务器上的玩家显示。
# 示例 3:特定服务器的标题消息(特性 #2)
- servers:
- "lobby"
type: "TITLE"
lines:
- "&b欢迎来到大厅!" # 第 1 行是主标题 (TITLE)
- "&7看看新的小工具吧!" # 第 2 行是副标题 (SUBTITLE)
# 示例 4:原版生存模式消息
- servers:
- "survival"
lines:
- "&c小心!这是一个启用 PvP 的服务器。"
Velocity
/plugins/CyAnnouncerVelocity/config.yml
默认配置
# ===================================================================
# CyAnnouncerVelocity 配置
# ===================================================================
#
# 插件作者: cydev-id
# 插件版本: 1.0.2
#
# 如何使用此文件:
#
# - 使用 '&' 符号表示颜色代码(例如 &a 表示绿色,&l 表示加粗)。
# - YAML 对空格敏感。请勿使用制表符;请使用空格。
# 缩进对于结构至关重要。
#
# ===================================================================
# 每个服务器每次公告之间的默认间隔时间(秒)。
# 例如,如果玩家处于生存服务器,他们将在其公告循环中每 60 秒看到一条新消息。
interval: 60
# 出现在每行公告前的前缀。
# 设置为 ""(空引号)以完全禁用前缀。
prefix: "&e[&l!&r&e] &r"
# (新增)--- 设置部分(特性 #3)---
settings:
# 设置为 true,以便在每个循环中从所有可用消息(全局 + 特定)中随机选择一条。
# 设置为 false 以使用默认的按顺序循环(默认值)。
random: false
# ===================================================================
# 公告部分
# ===================================================================
#
# 工作原理:
# 此插件为每个服务器使用智能且独立的循环系统。
#
# 1. 拥有自己特定消息的服务器(例如 'survival')将创建一个
# 独特的循环:(全局消息 -> 特定生存消息 1 -> 特定生存消息 2 -> 全局消息 -> ...)
#
# 2. 没有特定消息的服务器(例如 'lobby')将仅循环
# 浏览全局消息:(全局消息 1 -> 全局消息 2 -> 全局消息 1 -> ...)
#
# 每个服务器的循环独立运行,互不影响。
#
announcements:
# --- 全局公告 ---
# 这些消息将成为每个服务器循环的一部分。
# 要使某条消息成为全局消息,请将其添加到 'servers' 列表中并包含 "all"。
# 示例 1:标准聊天消息(默认)
- servers:
- "all"
lines:
- "&e别忘了每天为我们的服务器投票!"
- "&f使用命令 &b/vote&f 获取奖励。"
# 示例 2:带有声音的全局动作栏消息(特性 #2 和 #5)
- servers:
- "all"
type: "ACTIONBAR" # (新增)类型:CHAT、ACTIONBAR 或 TITLE
sound: "entity.player.levelup" # (新增)声音(使用 Minecraft 键名,例如 'block.note_block.pling')
lines:
- "&d查看我们的网店以获取独家等级和物品!"
# 注意:ACTIONBAR 仅使用第一行。
# --- 服务器特定公告 ---
# 这些消息将仅向指定服务器上的玩家显示。
# 它们将在全局消息之后插入到循环中。
# 示例 3:用于 Skyblock/Oneblock(特性 #2)的 TITLE 消息
- servers:
- "oneblock"
- "skyblock" # 你可以使用同一个消息块来针对多个服务器。
type: "TITLE"
lines:
- "&a欢迎来到天空!" # 第 1 行是主标题 (TITLE)
- "&f输入 &b/is&f 开始你的冒险。" # 第 2 行是副标题 (SUBTITLE)
- servers:
- "oneblock"
- "skyblock"
lines:
- "&b正在寻找队友?使用 &a/team&b 与他人合作吧!"
# 示例 4:用于 Survival 的标准聊天消息
- servers:
- "survival"
lines:
- "&c小心!野外已开启 PvP。"
- "&f使用金铲锹圈地以保障安全。"
许可证
本项目遵循 MIT 许可协议
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
- Download
CyAnnouncerBukkit-1.0.0.jar (Use the Latest Version).
- Place the JAR file in your Bukkit/Spigot server's
plugins/ folder.
- Restart your server.
- Change the configuration as desired in
plugins/CyAnnouncerBukkit/config.yml.
For BungeeCord
- Download
CyAnnouncerBungee-1.0.0.jar (Use the Latest Version).
- Place the JAR file in your Bungee proxy's
plugins/ folder.
- Restart your proxy.
- Change the configuration as desired in
plugins/CyAnnouncerBungee/config.yml.
For Velocity
- Download
CyAnnouncerVelocity-1.0.0.jar (Use the Latest Version).
- Place the JAR file in your Velocity proxy's
plugins/ folder.
- Restart your proxy.
- 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
评论 0
登录后参与评分
还没有评论,来抢沙发吧