LiteAnnouncer (BungeeAutoMessage) - LiteAnnouncer - 轻量公告系统

💡简介

LiteAnnouncer 是一款极其简洁的自动消息公告插件，无需任何软依赖！它支持 JSON 文本行，并兼容 BungeeCord 1.7 至 1.13 的所有版本。

🎮命令

• /Announcer - 显示帮助信息。
• /Announcer commands - 显示命令帮助。
• /Announcer alert <消息> - 从控制台向所有玩家发送消息（支持变量）。
• /Announcer order <NORMAL/RANDOM> - 设置消息播放顺序。
• /Announcer interval <秒数> - 设置消息发送间隔（秒）。
• /Announcer reload - 重载插件配置。
• /Announcer list - 列出所有已配置的消息。
• /Announcer toggle - 开启或关闭插件功能。

🎮权限

• announcer.admin - 管理员权限，可使用所有命令、查看完整帮助信息和命令提示。

🎮配置文件

配置文件主要包含 Settings（设置）和 Messages（消息）两部分。

设置部分

Settings:
  messagesOrder: NORMAL
  interval: 60
  minOnlineCountForWork: 1
  noPermMessage: §cYou don't have permissions!
  enableVariables: true
  debugJsonErrors: false

• messagesOrder：消息播放顺序，可选 NORMAL（顺序）或 RANDOM（随机）。
• interval：消息发送间隔时间（秒）。
• minOnlineCountForWork：插件开始工作所需的最小在线玩家数。
• noPermMessage：玩家无权限时的提示信息。
• enableVariables：是否启用变量替换。
• debugJsonErrors：是否启用 JSON 错误调试。

消息部分

消息以数字 ID 为键进行配置，每个消息包含以下节点：

• SHOWMODE：消息发送模式。可选 ALLSERVERS（所有服务器）、ONLYFOR（仅限指定服务器）或 EXCEPTFOR（除指定服务器外）。
• SERVERS：服务器名称列表。当 SHOWMODE 为 ONLYFOR 或 EXCEPTFOR 时必须配置。
• LINES：消息文本行列表。支持普通文本和 JSON 格式。

消息节点说明

• SHOWMODE：决定消息发送到哪些服务器。默认为 ALLSERVERS。
• SERVERS：服务器名称列表，仅在 SHOWMODE 为 ONLYFOR 或 EXCEPTFOR 时需要配置。
• LINES：消息内容行，可以包含多行或单行，支持变量和 JSON。

✨JSON 使用

消息的每一行都可以是一个 JSON 组件数组或纯文本。你可以使用在线工具（如 minecraftjson.com）来生成 JSON 行。配置文件中已包含示例。

[%] 变量（Placeholders）

插件内置以下变量，可在消息中使用

• %player% - 玩家显示名
• %playerIP% - 玩家 IP 地址
• %playerPing% - 玩家延迟（毫秒）
• %playerUUID% - 玩家 UUID
• %playerVersion% - 玩家客户端版本
• %playerCountry% - 玩家所在国家/地区
• %onlineCount% - BungeeCord 总在线玩家数
• %server% - 玩家当前所在服务器（来自 Bungee 配置）

🔧开发者 API（变量扩展）

如果你是开发者，可以添加自己的变量。

获取当前变量

/**
* 返回当前所有已激活变量的不可变 Map
* 类型: Map<String, Function<ProxiedPlayer, String>>
*/
LiteAnnouncer.getPlaceholders();

添加自定义变量

/**
* 添加自定义变量。
* 示例: LiteAnnouncer.addPlaceholder("%viewDistance%", player -> String.valueOf(player.getViewDistance()));
*/
LiteAnnouncer.addPlaceholder(String placeholder, Function<ProxiedPlayer, String> replaceFunction);

移除变量

/**
* 移除指定变量。
* 示例: LiteAnnouncer.removePlaceholder("%viewDistance%");
*/
LiteAnnouncer.removePlaceholder(String placeholder);

❓安装说明

请注意：这是一个 BungeeCord 插件，不适用于 Spigot 或 Bukkit 服务器。

• 将下载的 LiteAnnouncer.jar 文件放入 BungeeCord 服务器的 /plugins 文件夹。
• 重启你的 BungeeCord 服务器。

⭐注意事项

• 插件基于 Java 8 开发。
• 如果你喜欢这个插件，别忘了给它一个五星评价！