CompatGuard

插件

· 作者 RayAstra

智能插件兼容性审计与更新管理器。自动检测过时的插件,评估风险,并支持游戏内一键更新。

0 本站下载 0 关注 更新于 6 个月前

最新 0.1.0 · 1.21.11 · Paper

一键开服(送7天)

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> 查看详细单插件报告

? 智能自动更新检测

  • 零手动配置 — 自动查找更新源:
    1. 解析插件的 website 字段以获取 GitHub URL
    2. 按插件名称搜索 Modrinth(模糊匹配)
    3. 按插件名称搜索 Spiget (SpigotMC)
    4. 探测常见的 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: [

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源