Troubleshooting

Use this guide to narrow down a problem before asking for support. You need your plugin versions and a complete startup log. Reproduce the issue on a test server with the smallest relevant setup.

Check the basics

• Did the plugin enable successfully?
• Are all required dependencies installed and enabled?
• Does your Java and server version match the release requirements?
• Is the player in the intended world and using the expected permissions?
• Did the problem start after a configuration change or update?

Read the first error

Later errors may be consequences of an earlier failure. Start at the first relevant exception during startup and include its cause when recording the issue.

Reduce the reproduction

Use a backup or test server. Keep the required dependencies, then remove unrelated optional integrations one at a time. Write down the exact steps that trigger the issue and what you expected instead.

Prepare a useful report

Include the plugin name and version, server software, Java version, reproduction steps, and relevant logs. Redact credentials and private player information. Share the report with your server’s administrator or the support channel listed by the plugin author.