CompatGuard
Paper 1.21.x 服务器的智能插件管理器。
CompatGuard 帮助服务器管理员即时查看哪些插件已过时或不兼容——无需任何配置。它自动检测更新源,评估兼容性风险,并允许你通过游戏内单击即可一键更新插件。
✨ 功能特性
? 插件兼容性扫描
- 在服务器启动时(或按需)扫描每个已安装插件的元数据
- 将每个插件分类为五个风险等级:
- ✅ 安全 (SAFE) — 当前 api-version,未检测到问题
- ? 可能安全 (LIKELY SAFE) — api-version 略旧但运行稳定
- ? 需审查 (REVIEW NEEDED) — api-version 较旧或缺失元数据
- ? 高风险 (HIGH RISK) — api-version 非常旧,不兼容可能性高
- ? 失败/已禁用 (FAILED / DISABLED) — 插件加载失败
rules.yml中可配置评分规则- 使用
/cg report <name>查看详细单插件报告
? 智能自动更新检测
- 零手动配置 — 自动查找更新源:
- 解析插件的
website字段以获取 GitHub URL - 按插件名称搜索 Modrinth(模糊匹配)
- 按插件名称搜索 Spiget (SpigotMC)
- 探测常见的 GitHub 发布文件名模式作为后备方案
- 解析插件的
- 对于小众或私有插件,可通过
sources.yml进行手动覆盖
⬆️ 安全的游戏内更新
- 加入服务器时(若存在更新),会出现可点击的
[✔ 立即更新]/[✘ 跳过]按钮 - 更新文件暂存于
plugins/update/目录——正在运行的服务器 JAR 不会被修改 - 在下一次服务器重启时,通过 Paper 内置的更新机制应用更新
- 暂存完成后,会出现可点击的
[✔ 立即重启]/[✘ 稍后]提示 - 下载前将旧 JAR 备份至
plugins/backup/(可配置,默认开启)
? 启动时自动更新
- 启用
auto-update: true可在启动时自动下载所有可用更新 - 可选
auto-restart-after-update: true实现完全无干预的更新循环 - 支持配置延迟时间,确保异步检查完成后再开始下载
? Discord Webhook 通知
- 当发现更新时,向你的 Discord 频道发送富嵌入消息
- 颜色编码:? 橙色表示有更新,? 绿色表示全部正常
- 列出每个过时插件的旧版本 → 新版本及来源类型
- 页脚中的服务器名称可配置
? 管理工具
| 命令 | 描述 |
|---|---|
/cg |
打开分页 GUI 或控制台摘要 |
/cg scan |
立即重新扫描所有插件 |
/cg checkupdates |
检查更新(异步)并打印结果 |
/cg update <name> |
下载并对特定插件进行暂存更新 |
/cg debug <name> |
显示完整的更新状态:版本、来源、URL、JAR 路径 |
/cg report [name] |
全服或单插件报告 + JSON 导出 |
/cg reload |
重载所有配置文件 |
? 报告
- JSON 报告保存至
plugins/CompatGuard/reports/ - 包含每个插件的版本、状态、评分、警告信息及更新结果
⚙️ 配置亮点
# 自动检测源(GitHub, Modrinth, Spiget)— 无需手动设置
auto-detect-sources: true
# 从所有检查中排除的插件
ignore:
- SomePrivatePlugin
# 启动时自动下载更新
auto-update: false
# 当 OP 加入时,通过可点击的更新提示通知他们
notify-ops-on-join: true
# 暂存新版本前备份旧 JAR(强烈建议)
backup-before-update: true
# 每 N 小时自动重新扫描(0 = 关闭)
auto-scan-interval-hours: 0
# 用于更新报告的 Discord webhook
discord:
enabled: false
webhook-url: ""
server-name: "My Server"
?️ 安全保证
- 默认只读 — 除非使用更新功能,否则不会触碰任何文件
- 仅 HTTPS 下载 — 拒绝 HTTP URL
- 50 MB 下载上限 — 防止意外下载大文件
- 原子暂存 — 文件先写入临时文件然后重命名,防止损坏
- 更新前备份 — 旧 JAR 保存至
plugins/backup/以便轻松回滚
? 要求
- Paper 1.21.x (Purpur 应该也能工作)
- Java 21+
? 贡献与支持
- Discord: [
你是这个资源的作者?登录后可认领此资源。
相似资源
数据包事件PacketEvents
retrooper
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
前置科技
27
ExyliaLib
ExyliaServices
ExyliaPlugins 的库。
前置实用
26
ProAuthMeLogin
3623813757
通过对话框或铁砧界面帮助你的 Anthme
实用
16
Vessel
muhdfdeen
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
生物存储
13
Vivecraft Spigot Extension
fayer3
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
前置实用
12
旅行地图
mysticdrew
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。
冒险实用
12
评论 0
登录后参与评分
还没有评论,来抢沙发吧