一个 Paper 插件,用于检查已安装插件在 Modrinth 上是否有更新,并可为你下载它们。更新信息会在控制台、玩家加入时通知 OP、通过 /updatecheck 按需触发,以及可选地发送到 Discord 机器人频道。所有检查均在非主线程运行。适用于 Paper、Purpur 和 Folia。
插件通过其 jar 文件的 sha512 哈希值进行识别,因此可以精确匹配到对应的 Modrinth 项目和版本,无需猜测名称。对于 Modrinth 未知的 jar 文件,会回退到使用名称匹配;完全不在 Modrinth 上的插件(如 ProtocolLib)则作为最后手段在 Hangar 上查找。除非启用,否则忽略 Alpha 和 Beta 构建。
命令与权限
| 命令 | 权限 | 默认值 |
|---|---|---|
/updatecheck |
versioneye.check |
op |
/updatecheck -prerelease (本次检查包含 alpha/beta 上传) |
versioneye.check |
op |
/updatecheck download [plugin] (获取更新,重启后生效) |
versioneye.download |
op |
/updatecheck ignore <plugin> (静音当前更新,直到有新版本) |
versioneye.ignore |
op |
/updatecheck unignore <plugin> |
versioneye.ignore |
op |
/updatecheck reload (重新读取 config.yml 而无需重启) |
versioneye.reload |
op |
| 加入通知 | versioneye.notify |
op |
配置
| 选项 | 默认值 | 作用 |
|---|---|---|
check-interval-hours |
6 |
重新检查的频率 (0 = 仅启动时检查) |
notify-on-join |
true |
允许的玩家加入时发送通知 |
require-matching-game-version |
false |
仅计算标记为当前 MC 版本的发布 |
include-prereleases |
false |
也将 alpha/beta 上传视为更新 |
check-hangar |
true |
对于不在 Modrinth 上的插件,回退到 Hangar |
auto-download |
false |
自动将更新下载到 plugins/update |
discord-webhook |
"" |
将新更新发布到 Discord 机器人频道 |
ignored-versions |
{} |
被静音的更新,由 /updatecheck ignore 管理 |
overrides |
{} |
将插件固定到某个 Modrinth slug 或 hangar:<slug> |
exclude |
[VersionEye] |
要跳过的插件 |
下载的更新会保存到服务器更新文件夹中,文件名与已安装的 jar 相同,并根据源站发布的哈希值进行验证;Paper 会在下次重启时替换它们。
如果某插件显示为未找到或匹配了错误的项目,可将其固定到 Modrinth slug 或 Hangar 项目 slug,或将其排除:
overrides:
Essentials: essentialsx
ProtocolLib: hangar:ProtocolLib
exclude:
- SomeWeirdPlugin
A Paper plugin that checks your installed plugins for updates on
Modrinth and can download them for you. Updates
are reported in the console, to ops when they join, on demand with
/updatecheck, and optionally to a Discord webhook. All checks run off
the main thread. Works on Paper, Purpur, and Folia.
Plugins are identified by the sha512 hash of their jar, so they are matched to their exact Modrinth project and release with no name guessing. Jars Modrinth doesn't know fall back to name matching, and plugins that aren't on Modrinth at all (like ProtocolLib) are looked up on Hangar as a last resort. Alpha and beta builds are ignored unless enabled.
Commands and permissions
| Command | Permission | Default |
|---|---|---|
/updatecheck |
versioneye.check |
op |
/updatecheck -prerelease (include alpha/beta uploads for this check) |
versioneye.check |
op |
/updatecheck download [plugin] (fetch updates, applied on restart) |
versioneye.download |
op |
/updatecheck ignore <plugin> (mute the current update until a newer one) |
versioneye.ignore |
op |
/updatecheck unignore <plugin> |
versioneye.ignore |
op |
/updatecheck reload (re-read config.yml without a restart) |
versioneye.reload |
op |
| Join notifications | versioneye.notify |
op |
Config
| Option | Default | What it does |
|---|---|---|
check-interval-hours |
6 |
How often to re-check (0 = startup only) |
notify-on-join |
true |
Notify permitted players on join |
require-matching-game-version |
false |
Only count releases tagged for your MC version |
include-prereleases |
false |
Also count alpha/beta uploads as updates |
check-hangar |
true |
Fall back to Hangar for plugins not on Modrinth |
auto-download |
false |
Download updates into plugins/update automatically |
discord-webhook |
"" |
Post new updates to a Discord webhook |
ignored-versions |
{} |
Muted updates, managed by /updatecheck ignore |
overrides |
{} |
Pin a plugin to a Modrinth slug or hangar:<slug> |
exclude |
[VersionEye] |
Plugins to skip |
Downloaded updates go to the server's update folder under the installed jar's filename and are verified against the source's published hash; Paper swaps them in on the next restart.
If a plugin shows as not found or matches the wrong project, pin it to a Modrinth slug or a Hangar project slug, or exclude it:
overrides:
Essentials: essentialsx
ProtocolLib: hangar:ProtocolLib
exclude:
- SomeWeirdPlugin
下载 VersionEye
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VersionEye
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VersionEye
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VersionEye
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VersionEye
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 VersionEye
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
可靠性更新,由一次真实的 Modrinth API 中断事件触发,该中断导致某服务器上的 28 项检查中有 21 项失败。
已修复
- 失败的检查不再被视为“已是最新”。摘要现在会排除这些失败的检查,并明确列出哪些插件无法被检查,无论是计划任务中的检查还是
/updatecheck命令。 - API 中断不再清除 VersionEye 已有的数据。在断网前发现的更新仍然可用于
/updatecheck download和/updatecheck ignore,并且加入通知功能继续保持正常工作。
变更
- 当收到 5xx 响应或发生网络错误时,查询操作将重试一次,两次重试之间间隔两秒,因此短暂的 API 波动不再导致整个检查失败。Discord Webhook 不会被重试,因此不会重复播报相同的更新信息。
- 如果连续四次向同一 API 主机发起请求均失败,则本次运行中对该主机的剩余检查将被跳过,仅显示一条“似乎已宕机”的警告,而非一系列超时和逐个插件的警告。下一次检查将从头开始。
- 请求超时时间从 15 秒缩短至 10 秒;结合重试机制后,最坏情况下的检查总耗时基本保持不变,同时能更好地处理缓慢响应的情况。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧