ServerPatch
一个简单的手动插件更新工具,适用于 Paper 系列服务器。检查更新、审阅计划,然后在准备好时应用;不会在后台运行任何任务。
功能特性
- 检查 Modrinth 和 Hangar 上的兼容更新
- 保存加密的快照,确保
/sp update仅应用你已审阅的内容 - **试运行(Dry-run)**模式 — 在不下载或替换 JAR 文件的情况下模拟更新
- 替换前进行 校验和 验证及
api-version检查 - 每次更新前创建备份,支持全量或单个插件的回滚
- 将插件固定到最大版本,或忽略你手动管理的插件
- 提供更新日志预览,并在涉及重大/破坏性更新时要求确认
- 异步网络操作 — 不占用主线程
快速开始
/sp check # 扫描插件并保存更新计划
/sp status # 查看待处理的更新
/sp update # 应用计划(若为重大/破坏性更新则需确认)
更新后请重启服务器。
命令
| 命令 | 作用 |
|---|---|
/sp check [--plugin <name>] |
扫描更新 |
/sp dryrun |
模拟更新而不更改文件 |
/sp status |
显示待处理快照及相关指标 |
/sp update [confirm] |
应用快照 |
/sp changelog <plugin> |
查看发行说明 |
/sp pin set/remove/list |
锁定每个插件的最大版本 |
/sp ignore add/remove/list |
跳过指定插件的检查 |
/sp rollback <plugin> [confirm] |
从备份恢复单个插件 |
/sp backup restore <folder> [confirm] |
恢复完整备份 |
别名:/serverpatch — 权限:serverpatch.admin(默认:OP)
支持的服务器
- Paper、Purpur、Spigot、Folia
- Minecraft 1.20.x、1.21.x 以及 26.x(请选择匹配的 JAR 文件)
注意事项
-
无静默自动更新 — 你必须自行运行检查与更新操作
-
当无法安全直接下载时,SpigotMC 仅提供元数据
-
跳过付费或不兼容的插件,而非猜测其状态
-
由 Sahil Waheed (Shiraken12T) 制作
ServerPatch
A simple, manual plugin updater for Paper-family servers. Check for updates, review the plan, then apply when you are ready nothing runs in the background.
Features
- Checks Modrinth and Hangar for compatible updates
- Saves an encrypted snapshot so
/sp updateonly applies what you reviewed - Dry-run mode — simulate updates without downloading or replacing JARs
- Checksum verification and
api-versionchecks before replace - Backups before every update, with full or per-plugin rollback
- Pin plugins to a max version or ignore plugins you manage manually
- Changelog preview with confirmation for major/breaking updates
- Async network work — stays off the main thread
Quick start
/sp check # scan plugins and save update plan
/sp status # review pending updates
/sp update # apply the plan (confirm if major/breaking)
Restart the server after updating.
Commands
| Command | What it does |
|---|---|
/sp check [--plugin <name>] |
Scan for updates |
/sp dryrun |
Simulate without changing files |
/sp status |
Show pending snapshot and metrics |
/sp update [confirm] |
Apply snapshot |
/sp changelog <plugin> |
View release notes |
/sp pin set/remove/list |
Lock max version per plugin |
/sp ignore add/remove/list |
Skip plugins from checks |
/sp rollback <plugin> [confirm] |
Restore one plugin from backup |
/sp backup restore <folder> [confirm] |
Restore a full backup |
Alias: /serverpatch — permission: serverpatch.admin (default: OP)
Supported servers
- Paper, Purpur, Spigot, Folia
- Minecraft 1.20.x, 1.21.x, and 26.x (pick the matching JAR)
Notes
-
No silent auto-updates — you always run check and update yourself
-
SpigotMC is metadata-only when a safe direct download is not available
-
Premium or incompatible plugins are skipped instead of guessed
-
Made by Sahil Waheed (Shiraken12T)
下载 ServerPatch
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ServerPatch
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ServerPatch
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ServerPatch
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ServerPatch
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ServerPatch
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ServerPatch
下载 ServerPatch
下载 ServerPatch
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 ServerPatch
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
ServerPatch 更新日志
1.3.0
新增
- 通过
/sp ignore add|remove|list(存储在ignored.txt)实现按插件的忽略列表。 /sp status中显示 Modrinth 和 Hangar 待更新项目的更新日志链接。- 检查期间预加载 Modrinth 批量项目,以减少 API 往返调用。
- 检查结果采用颜色编码(绿色 = 已是最新,黄色 = 可更新,红色 = 跳过/错误)。
- 替换前对下载的 JAR 进行 API 版本兼容性检查。
/sp update期间UPDATE_FAILED时发送 Discord/webhook 通知。- 配置项
safety.maxConcurrentDownloads(默认值为 3),用于控制并行下载数量。 /sp check --plugin <name>用于检查单个插件。- 通过
backups.maxBackups配置项清理备份文件夹(优先删除最旧的)。 - 加载时验证快照完整性哈希。
/sp dryrun模拟更新过程,不执行下载或 JAR 替换。/sp pin set|remove|list用于设置每个插件的最高版本限制。/sp rollback <plugin> [confirm]从最新备份恢复单个插件。- 在每次运行的 JAR 备份旁生成配置文件文件夹备份。
- 快照/状态中显示语义化更新分类(
PATCH、MINOR、MAJOR、UNKNOWN)。 - 本地存储更新日志历史记录,支持
/sp changelog <plugin> [page]。 - 检查期间从 Modrinth/Hangar API 响应中获取更新日志文本。
/sp update confirm重大或破坏性更改更新的确认机制(10 秒窗口)。- Maven 配置了
mc-1.20、mc-1.21和mc-26配置文件,并使用平台标记的 JAR 文件名(paper、purpur、spigot)。 scripts/build-all-jars.ps1脚本可在一次运行中生成所有版本/平台变体。- 为 Paper、Spigot、Purpur 和 Folia 添加了
PlatformInfo检测脚手架。 - 为 Paper、Spigot、Purpur 和 Folia 添加了
PlatformInfo检测脚手架。
更改
- 命令集简化:
check、status、update、backup restore、ignore、help。 - 别名更改为
/sp(原为/updater)。/serverpatch仍然有效。 /sp status替代了snapshot-status,并包含上次运行的指标数据。/sp update替代了run,当不存在有效快照时自动运行检查。- 备份恢复使用单一命令,可选附加
confirm(10 秒窗口)。 - 重启警告静音功能移至配置中的
notifications.muteRestartWarning。 - Java 包名从
com.universalupdater重命名为com.serverpatch。 - 文档已对齐至 Java 25(与
pom.xml匹配)。 - 快照完整性现在包含条目内容,而不仅仅是环境、计数和时间戳。
修复
- 当 Spiget 未提供加载器列表时,SpigotMC 元数据不再导致严格模式下的加载器检查失败。
- 通过完整性哈希验证检测快照篡改(无效快照将被删除)。
backups.maxBackups现严格执行,优先删除最旧的备份。- 修复 CHANGELOG/README 与
pom.xml之间的 Java 版本不匹配问题。
移除
- 未使用的类:
DryRunService、BootStateManager、RollbackExecutor、RestartManager。 - 仅用于显示的
mode配置项(CHECK_ONLY/DOWNLOAD_ONLY/AUTO_UPDATE)。 /sp silent命令(请使用notifications.muteRestartWarning代替)。- 配置节:
rollback.*、restart.*、debug-mode。 - 从
plugin.yml中移除占位符website字段。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
评论 0
登录后参与评分
还没有评论,来抢沙发吧