Docket

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.