SmartBroadcast

插件

· 作者 Kush_ShuL

SmartBroadcast 是一个适用于 Paper/Folia 1.20.1 的插件,它通过基于表达式的规则动态控制 Minecraft 局域网发现广播,并支持 PlaceholderAPI 和 MiniMessage。

0 本站下载 0 关注 更新于 5 个月前

最新 1.0.0 · 1.20.6 · Folia / Paper

一键开服(送7天)

SmartBroadcast

中文

SmartBroadcast 是一款适用于 Paper / Folia 1.20.1 的智能 Minecraft 局域网发现协议广播插件。它根据可配置的表达式规则,决定何时广播局域网服务器信息以及广播什么 MOTD。

功能特性

  • 支持 Folia:使用 GlobalRegionScheduler 和 AsyncScheduler,并在 plugin.yml 中设置 folia-supported: true
  • 支持 Minecraft 局域网发现协议:向 224.0.2.60:4445 发送 UDP 组播数据包
  • 多规则支持:规则按顺序检查,并使用第一个匹配的规则
  • 禁止广播规则:匹配的规则可以设置 broadcast: false 以抑制广播
  • 表达式条件:支持玩家数量、白名单状态、端口、MOTD、PlaceholderAPI 占位符等
  • PlaceholderAPI 支持:PAPI 占位符可用于表达式和 MOTD 值中
  • MiniMessage 支持:自定义 MOTD 值可以使用 MiniMessage 语法,并会被转换为旧版文本
  • 当前服务器 MOTD 支持:使用 {server_motd} 广播当前的 Paper MOTD
  • 热重载支持:/smartbroadcast reload

局域网发现协议

当多人服务器列表界面打开时,Minecraft 客户端会监听 224.0.2.60:4445 上的 UDP 组播数据包。服务器应在此格式下发送 UTF-8 字符串:

[MOTD]<server MOTD>[/MOTD][AD]<server port>[/AD]

重要提示:此协议不支持 Adventure 富文本组件。SmartBroadcast 在广播前会将 MiniMessage 或当前服务器 MOTD 转换为旧版 § 文本,以便客户端正确解析。

默认行为

默认情况下,插件仅在至少有一名玩家在线时广播当前服务器 MOTD:

rules:
  - name: "players-online"
    expression: "online > 0"
    broadcast: true
    motd: "{server_motd}"

如果没有规则匹配,则不会发送任何局域网数据包。

安装

  1. 构建插件:
./gradlew shadowJar
  1. 将生成的 JAR 文件复制到服务器的 plugins 目录中:
build/libs/SmartBroadcast-1.0.0.jar
  1. 启动你的 Paper / Folia 1.20.1 服务器。
  2. 如果需要 PlaceholderAPI 支持,请同时安装 PlaceholderAPI。

命令与权限

命令 权限 描述
/smartbroadcast reload smartbroadcast.admin 重新加载配置
/sbc reload smartbroadcast.admin 重新加载配置
/lanbroadcast reload smartbroadcast.admin 重新加载配置

配置

broadcast:
  enabled: true
  address: "224.0.2.60"
  port: 4445
  interval-millis: 1500
  advertised-port: -1
  • enabled:是否启用广播
  • address:局域网发现组播地址,默认为 224.0.2.60
  • port:局域网发现组播端口,默认为 4445
  • interval-millis:广播间隔;原版约为 1500ms
  • advertised-port:向客户端广播的服务器端口;-1 表示使用当前服务器端口

表达式规则

规则从上到下依次检查。第一个计算结果为真的规则将被使用。

布尔运算符

&&  and (且)
||  or (或)
!   not (非)

示例:

expression: "online > 0 && !whitelist"

括号

expression: "(online > 0 && !whitelist) || %server_tps_1% >= 18"

比较运算符

==  equals (等于)
!=  not equals (不等于)
>   greater than (大于)
>=  greater than or equal (大于等于)
<   less than (小于)
<=  less than or equal (小于等于)

字符串运算符

contains  contains substring (包含子串)
matches   regular expression match (正则表达式匹配)

示例:

expression: "motd contains 'Survival'"
expression: "%server_name% matches 'Lobby.*'"

字面量

支持的字面量:

  • true
  • false
  • 数字,如 0 和 18.5
  • 字符串,如 'Lobby' 或 "Survival"

内置变量

变量 类型 描述
online number 当前在线玩家数量
max_players number 最大玩家数量
port number 向客户端广播的端口
whitelist boolean 白名单是否启用
motd string 当前服务器 MOTD 的纯文本形式

PlaceholderAPI

安装 PlaceholderAPI 后,PAPI 占位符可直接用于表达式和 MOTD 值中:

expression: "%server_online% > 0"
expression: "%server_tps_1% >= 18"
expression: "%server_name% contains 'Lobby'"

motd: "<green>%server_online%</green><gray>/</gray><yellow>%server_max_players%</yellow>"

MOTD 渲染

广播当前服务器 MOTD

motd: "{server_motd}"

插件读取当前的 Paper MOTD,并在广播前将其转换为旧版文本。

自定义 MiniMessage MOTD

motd: "<gradient:#55ff55:#00aaaa>SmartBroadcast</gradient> <gray>|</gray> <yellow>%server_online%</yellow>"

处理流程:

  1. 应用 PlaceholderAPI
  2. 解析 MiniMessage
  3. 转换为旧版 § 文本
  4. 使用局域网发现协议发送 UDP 组播数据包

多规则示例

rules:
  - name: "hide-when-whitelist"
    expression: "whitelist == true"
    broadcast: false

  - name: "good-tps"
    expression: "online > 0 && %server_tps_1% >= 18"
    broadcast: true
    motd: "{server_motd}"

  - name: "fallback"
    expression: "online > 0"
    broadcast: true
    motd: "<yellow>Server is online</yellow>"

构建要求

  • Java 17+
  • Gradle
  • Paper API 1.20.1

构建命令:

./gradlew shadowJar

如果本地没有 Gradle Wrapper,请使用已安装的 Gradle 发行版:

gradle shadowJar

测试建议

  • 在 Folia 1.20.1 上启动插件,并确认控制台无报错
  • 运行 /smartbroadcast reload 以测试热重载
  • 保持至少一名玩家在线,并从同一局域网内的客户端刷新多人服务器列表
  • 测试 broadcast: false 是否禁止广播
  • 安装 PlaceholderAPI 并测试诸如 %server_online% 和 %server_tps_1% 等表达式

许可证

本项目遵循 GNU General Public License v3.0 开源协议。详情请参阅 LICENSE。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源