你的插件保持更新,一切由你掌控。
大多数服务器发现插件过时往往是通过痛苦的方式:
比如崩溃、安全警告,或者有玩家告诉他们。
PluginPulse 会检查你的插件在哪里发布更新,
当有新版本时通知你,并可以为你安装它。
| 没有 PluginPulse | 使用 PluginPulse |
|---|---|
| 访问每个插件页面以查看更新内容 | 一个列表即可显示所有滞后项 |
| 手动下载、重命名和复制 jar 文件 | 一条命令,或完全自动化 |
| 错误的下载会导致服务器崩溃 | 每次下载在使用前都会经过检查 |
| 更新出错意味着要费力寻找旧版 jar | /pluginpulse restore 一键还原 |
| 下载了不适配当前 Minecraft 版本的 jar | 自动为你选择适配服务器的版本 |
设置
- 将 jar 放入
plugins/目录并启动服务器 - 在
plugins/PluginPulseCompanion/config.yml中列出你想要保持更新的插件 - 运行
/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
你知道我还有其他插件吗?在这里查看
Your plugins stay up to date, and you decide how far it goes.
Most servers find out a plugin is outdated the hard way,
from a crash, a security warning, or a player telling them.
PluginPulse checks where your plugins publish their updates,
tells you when one is out, and can install it for you.
| Without PluginPulse | With PluginPulse |
|---|---|
| Visit every plugin page to see what's new | One list shows what's behind |
| Download, rename and copy jars by hand | One command, or fully automatic |
| A bad download breaks your server | Every download is checked before it's used |
| A broken update means hunting for the old jar | /pluginpulse restore puts it back |
| The wrong jar for your Minecraft version | The one made for your server, picked for you |
Setup
- Drop the jar into
plugins/and start the server - List the plugins you want kept up to date in
plugins/PluginPulseCompanion/config.yml - Run
/pluginpulse reload
plugins:
EssentialsX: # the name /plugins shows
modrinth: essentialsx # where its updates come from
mode: notify # tell me, download nothing
The plugins you list don't need to know PluginPulse exists.
What it does
Finds updates
- Checks Modrinth, GitHub, Hangar, a Jenkins build server, or a web address you host
- Give a plugin more than one place to check, in the order you choose
- When a plugin makes separate downloads for 1.21 and 26.x, you get the one for your server
Tells you
- A notice in the console and in game for anyone with
pluginpulse.admin - Click the notice to open the download page, or run
/pluginpulse downloadto install it
Installs, only if you let it
- Each plugin gets its own mode, from "just tell me" to fully automatic
- Every download is checked against the checksum the author published. A damaged or tampered file is never used
- The old jar is backed up first, and the update is applied on your next restart
Waits out brand-new releases, if you like
- Sometimes an update is broken and fixed a few hours later
- Switch on
hold-new-updatesand PluginPulse waits until a release has been out for 18 hours /pluginpulse download <plugin>still installs one right away
Will it work on my server?
| Server software | Paper, Folia, Spigot, or a Paper fork like Purpur |
| Proxy | Velocity 3.4 to 4.3, with the download that has velocity in its name |
| Minecraft | 1.20.5 to 1.21.x with the plain download, 26.x (including 26.3) with the -mc26 download |
| Java | 21+ for 1.21.x, 25+ for 26.x |
| Anything else | Nothing. No dependencies |
On Spigot, notices are plain text with the link written out, instead of clickable.
On Velocity, a downloaded update is installed when the proxy shuts down, because Velocity can't swap a plugin while it runs. Its command is /pulseproxy (or /ppp) with the same actions, so /pluginpulse still reaches the companion on your servers. Give staff the pluginpulse.admin permission with a permissions plugin such as LuckPerms.
Reference
Commands
| Command | What it does |
|---|---|
/pluginpulse |
Every managed plugin, and whether it's up to date |
/pluginpulse check [plugin|all] |
Check now |
/pluginpulse download [plugin|all] |
Download the update, ready for the next restart |
/pluginpulse apply [plugin|all] |
Install a downloaded update without a restart (needs hot-reload: true) |
/pluginpulse restore [plugin|all] |
Go back to the previous version on the next restart |
/pluginpulse reload |
Re-read the settings file |
Also works as /ppc or /pulse.
Permissions
| Permission | What it does | Default |
|---|---|---|
pluginpulse.admin |
Use the commands and see update notices | OP |
Modes
| Mode | What happens when an update is found |
|---|---|
off |
Nothing, this plugin is ignored |
check-only |
Nothing, until you run /pluginpulse |
notify (default) |
You're told in the console and when you join. Nothing is downloaded |
download |
It's downloaded and checked, ready for your next restart |
auto-stage |
Same as download, as soon as the update is found |
Settings people change
plugins:
SomePlugin:
github: owner/repo # or modrinth, hangar, jenkins
mode: download
hot-reload: false # true = install without a restart, when it's safe
match-server-version: true # take the download made for your Minecraft version
user-agent-contact: "you@example.com" # Modrinth asks for a way to reach you
check-interval-hours: 6
hold-new-updates: false # true = wait until a release has been out a while
hold-new-updates-hours: 18
More info? Read about it in the guide
Making your own plugin update itself
PluginPulse is also a library. Add it to your plugin and it updates itself, with the same checks, notices and backups.
dependencies {
implementation("com.github.ESMP-FUN.PluginPulse:pluginpulse-core:v0.10.2")
}
tasks.shadowJar {
relocate("io.github.darkstarworks.pluginpulse", "my.plugin.libs.pluginpulse")
}
Then either drop a pluginpulse.yml into your resources and call PluginPulse.bootstrap(this), or use the builder for full control.
More info? Read about it in the library guide
Adding updates to a jar you can't rebuild
Have a plugin jar but no source code? The browser tool adds an updater to it. Pick the jar, say where its updates come from, and download the new jar.
Everything happens on the page. Your jar is never uploaded.
More info? Read about it in the browser tool guide
Help
- Discord - ask me directly. Tell me "if it did X, I'd use it" and there's a good chance it ships
- Guide - setup, plus where to find a plugin's updates and a glossary
- Bug reports, Source, Changelog
Paper, Folia, Spigot, Velocity
Minecraft 1.20.5 to 26.x, Java 21+
No dependencies
Free and source available.
Please consider donating: Ko-Fi or Patreon
Did you know I have other plugins? Check them out here
下载 PluginPulse
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PluginPulse
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PluginPulse
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PluginPulse
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PluginPulse
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PluginPulse
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PluginPulse
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PluginPulse
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 PluginPulse
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
[0.10.3] - 2026-10-27
已修复
- 通过浏览器工具或注入器配置的插件在更新后仍会持续检查更新。 该更新是作者提供的独立 jar 文件,其中不包含 PluginPulse,因此更新程序此前会在首次更新后消失。现在,PluginPulse 会在安装前将自身以相同的设置添加到新的 jar 文件中。如果无法完成此操作(例如作者更改了主类,或命令行工具就地修改了
final主类),控制台将会显示相应提示。
[0.9.0] - 2026-09-23
已在 Paper 26.3 (build 35) 和 Spigot 26.3 上测试:更新检查、下载、重启时安装、非重启安装以及配套插件。
Added
- 自动选择适合服务器 Minecraft 版本的下载文件。 当插件发布了多个独立的 jar 包(例如 1.21、26.1 和 26.3),PluginPulse 会直接选取 Modrinth 或 Hangar 中为当前服务器列出的版本,无需指定
track。可通过设置match-server-version: false关闭此功能。 - 在版本打标签时,自动构建并发布发布版,同时附带两个配套的 jar 包。
Fixed
- 在更新检查期间停止服务器不再打印错误信息。 之前会显示“催促作者”的错误提示,或者针对捆绑了 PluginPulse 的插件报出“zip 文件已关闭”的错误。
- 配套插件现在能管理在其之后启动的插件。 此前,它会根据服务器启用插件的顺序跳过它们,并显示“正在管理 0 个插件”。
- 非重启安装后,更新命令恢复正常。 之前它会继续与旧版本通信并失败,直到下一次重启。
- 在 Spigot 上,非重启安装也能正常工作。 之前会在中途失败,导致插件处于关闭状态且无可用命令,直到重启。
- 在 Paper 上,非重启安装不再重复执行插件的启动步骤。
- Spigot 上的更新通知显示正常。 之前按钮文本的一部分会以原始标记形式显示。
- 非重启安装现在尊重通过
paper-plugin.yml(而不仅仅是plugin.yml)声明的依赖关系。 update status能在首次检查前及检查失败后如实反馈状态。 之前在这两种情况下都会显示“已是最新版本”。- 自注册的更新命令现在会在玩家权限不足时明确提示,而不是毫无反应。
- 在 Modrinth 上,没有任何发布版的 track 不会再回退到使用其他 track 的 jar 包。 不带后缀的普通版本号仍会被接受。
- 系统语言设置为土耳其语的服务器将获得正确的默认权限(
plugin.update,而非无点 i 拼写)。 - 来自更新源的版本文本不再能改变可点击消息的行为。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
自定义你的Minecraft头像!
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
评论 0
登录后参与评分
还没有评论,来抢沙发吧