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.