Docket:插件兼容性扫描器
为 Paper 和 Spigot 服务器提供插件兼容性审计。
Docket 会在每次启动时运行兼容性扫描,并将结果直接打印到控制台。它会检查所有已安装插件之间的硬依赖缺失、命令冲突以及事件监听器优先级冲突,并按严重程度分组,同时给出一个服务器健康评分。
无需配置。将 jar 文件放入即可使用。
功能特性
- 字节码事件分析: 使用 ASM 9.7 读取插件 JAR 文件,映射事件处理器并检测监听器优先级冲突
- 依赖审计: 标记缺失的硬依赖和循环依赖链
- Luckperms 兼容: 拥有完整的 Luckperms 权限节点兼容性
- 命令冲突检测: 识别插件之间重叠的命令注册
- 健康评分: 根据详细发现将服务器评级为“极佳”、“良好”、“一般”或“较差”
- Discord Webhook: 在启动或重新扫描时将扫描报告发布到指定频道,无需机器人
- 游戏内报告: 分页显示
/plugincheck 输出,带有颜色编码的发现项和可点击的导航
- 大型服务器支持: 如果启动性能是主要顾虑,可在配置中禁用字节码分析
要求
|
|
| 服务器 |
Paper 1.21+ 或 Spigot 1.21+ |
| Java |
21 或更高版本 |
安装
将 docket-plugin-compatibility-1.0-RELEASE.jar 放入服务器的 plugins/ 文件夹并重启。扫描会自动运行,无需额外设置。有关命令、配置和 Discord 设置,请参阅 USAGE.md。
致谢
许可证
依据 Apache License 2.0 发布。完整条款请参阅 LICENSE。
Paper 1.21+ · 兼容 Spigot · Java 21+
Docket: Plugin Compatibility Scanner
Plugin compatibility auditing for Paper and Spigot servers.
Docket runs a compatibility scan on every startup and prints the results directly in your console. It checks hard dependency gaps, command collisions, and event-listener priority conflicts across all installed plugins, grouped by severity with a server health score.
No configuration required. Drop the jar in and it works.
What's Included
- Bytecode event analysis: reads plugin JARs using ASM 9.7 to map event handlers and detect listener priority conflicts
- Dependency auditing: flags missing hard dependencies and circular dependency chains
- Luckperms Compatibility: has permission nodes for full luckperms compatibility
- Command collision detection: identifies overlapping command registrations across plugins
- Health score: rates your server as Great, Good, Mild, or Bad with a full findings breakdown
- Discord webhook: posts scan reports to a channel on startup or rescan, no bot required
- In-game report: paginated
/plugincheck output with colour-coded findings and clickable navigation
- Large server support: bytecode analysis can be disabled in config if startup performance is a concern
Requirements
|
|
| Server |
Paper 1.21+ or Spigot 1.21+ |
| Java |
21 or newer |
Installation
Drop docket-plugin-compatibility-1.0-RELEASE.jar into your server's plugins/ folder and restart. The scan runs automatically with no additional setup. See USAGE.md for commands, configuration, and Discord setup.
Credits
|
|
| Development |
Docket Contributors |
| Bytecode Analysis |
ASM Library by OW2 Consortium |
| Server API |
PaperMC Team |
License
Released under the Apache License 2.0. See LICENSE for full terms.
Paper 1.21+ · Spigot-compatible · Java 21+
评论 0
登录后参与评分
还没有评论,来抢沙发吧