PluginPulse

插件

· 作者 darkstarworks

为每个插件添加自动更新功能

0 本站下载 0 关注 更新于 3 周前

最新 0.10.3-velocity · 26.3 · Velocity

一键开服(送7天)

PluginPulse


你的插件保持更新,一切由你掌控。

大多数服务器发现插件过时往往是通过痛苦的方式:
比如崩溃、安全警告,或者有玩家告诉他们。

PluginPulse 会检查你的插件在哪里发布更新,
当有新版本时通知你,并可以为你安装它。

没有 PluginPulse 使用 PluginPulse
访问每个插件页面以查看更新内容 一个列表即可显示所有滞后项
手动下载、重命名和复制 jar 文件 一条命令,或完全自动化
错误的下载会导致服务器崩溃 每次下载在使用前都会经过检查
更新出错意味着要费力寻找旧版 jar /pluginpulse restore 一键还原
下载了不适配当前 Minecraft 版本的 jar 自动为你选择适配服务器的版本

设置
  1. 将 jar 放入 plugins/ 目录并启动服务器
  2. 在 plugins/PluginPulseCompanion/config.yml 中列出你想要保持更新的插件
  3. 运行 /pluginpulse reload
plugins:
  EssentialsX:              # 插件显示的名称
    modrinth: essentialsx   # 更新来源
    mode: notify            # 仅通知,不下载

你列出的插件无需知道 PluginPulse 的存在。


功能说明

查找更新

  • 检查 Modrinth、GitHub、Hangar、Jenkins 构建服务器,或你托管的网址
  • 可为一个插件配置多个检查源,并按你指定的顺序进行
  • 当插件为 1.21 和 26.x 提供单独的下载时,你会获得适配你服务器的版本

通知你

  • 控制台和游戏内均有提示(需拥有 pluginpulse.admin 权限)
  • 点击通知可打开下载页面,或运行 /pluginpulse download 进行安装

安装,但仅在允许的情况下

  • 每个插件都有独立的模式,从“仅通知我”到全自动
  • 每次下载都会与作者发布的校验和进行比对,损坏或被篡改的文件绝不会使用
  • 旧版 jar 会先备份,然后在下一次重启时应用更新

如果你喜欢,可延迟安装最新发布的版本

  • 有时更新存在缺陷,几小时后才会修复
  • 开启 hold-new-updates 后,PluginPulse 会等待新版本发布 18 小时后再应用
  • /pluginpulse download <plugin> 仍可立即安装指定插件

是否适用于我的服务器?

服务端软件 Paper, Folia, Spigot, 或如 Purpur 等 Paper 分支
代理端 Velocity 3.4 至 4.3,需使用文件名中包含 velocity 的版本
Minecraft 版本 1.20.5 至 1.21.x 使用普通下载版,26.x(含 26.3)使用 -mc26 下载版
Java 版本 1.21.x 需要 Java 21+,26.x 需要 Java 25+
其他依赖 无。无任何外部依赖

在 Spigot 上,通知为纯文本形式,链接直接写出而非可点击。

在 Velocity 上,由于 Velocity 无法在运行时切换插件,因此代理关闭时才会安装下载的更新。其命令为 /pulseproxy(或 /ppp),支持相同操作,因此 /pluginpulse 仍能控制你服务器上对应的 Companion 插件。请通过 LuckPerms 等权限插件授予工作人员 pluginpulse.admin 权限。


参考文档

命令
命令 功能
/pluginpulse 显示所有受管插件及其更新状态
/pluginpulse check [插件|all] 立即检查更新
/pluginpulse download [插件|all] 下载更新,准备在下一次重启时应用
/pluginpulse apply [插件|all] 在不重启的情况下安装已下载的更新(需 hot-reload: true)
/pluginpulse restore [插件|all] 在下一次重启时回退到上一版本
/pluginpulse reload 重新读取配置文件

也支持简写 /ppc 或 /pulse。

权限
权限 功能 默认值
pluginpulse.admin 使用命令并查看更新通知 OP
模式
模式 发现更新时的行为
off 无操作,忽略此插件
check-only 无操作,直到你运行 /pluginpulse
notify (默认) 控制台和登录时通知,不下载任何内容
download 下载并校验,准备在下一次重启时应用
auto-stage 同 download,但在发现更新后立即执行
常用设置项
plugins:
  SomePlugin:
    github: owner/repo           # 也可以是 modrinth, hangar, jenkins
    mode: download
    hot-reload: false            # true = 安全时无需重启即可安装
    match-server-version: true   # 选择适配你 Minecraft 版本的下载

user-agent-contact: "you@example.com"   # Modrinth 要求提供联系方式
check-interval-hours: 6
hold-new-updates: false          # true = 等待新版本发布一段时间
hold-new-updates-hours: 18

更多信息?请在指南中阅读

让你的插件实现自动更新

PluginPulse 同时也作为一个库使用。将其添加到你自己的插件中,它便能实现自动更新,具备相同的检查、通知和备份机制。

dependencies {
    implementation("com.github.ESMP-FUN.PluginPulse:pluginpulse-core:v0.10.2")
}
tasks.shadowJar {
    relocate("io.github.darkstarworks.pluginpulse", "my.plugin.libs.pluginpulse")
}

然后,将 pluginpulse.yml 放入你的资源文件夹并调用 PluginPulse.bootstrap(this),或者使用构建器以获得完全控制。

更多信息?在库指南中阅读相关内容

向无法重新构建的 jar 添加更新

有一个插件 jar 但没有源代码?浏览器工具 可以为其添加更新程序。选择 jar 文件,指定其更新来源,然后下载新的 jar 包。

所有操作都在页面上完成。你的 jar 包永远不会被上传。

更多信息?在浏览器工具指南中阅读相关内容


帮助

Paper, Folia, Spigot, Velocity
Minecraft 1.20.5 至 26.x,Java 21+
无依赖项

免费且源码公开。
请考虑捐赠:Ko-Fi 或 Patreon

你知道我还有其他插件吗?在这里查看

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源