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

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

License

Released under the Apache License 2.0. See LICENSE for full terms.

Paper 1.21+ · Spigot-compatible · Java 21+