Skip to content

Getting Help the Right Way

Matej Pacan edited this page Oct 20, 2021 · 5 revisions

img

If you have a question, or a bug to report, this page guides you on how to report them and get the quickest and most efficient response.

Reading Stack Traces

Stack traces are the essential to allow you to see where exactly the problem lies. Make sure you always check your startup log and console for any errors when having issues. Paste the entire error log to pastebin.com.

When having that annoying error popping in your console, something went unexpected. To protect your data, the plugin rather shuts itself down than corrupting configuration files.

The key to understanding stack traces is to read them. For some people this is a matter of course, but sometimes (oftentimes) I receive issues that could easily be solved by just reading the error itself.

Many times it will tell what you need to do. Here for example, settings contains a value that cannot be set. I recommend checking the file content on this website. Other times it might be something else; take a bit of time to read and try to understand the error stack before posting issue. Also make sure your Java version and server version meet minimum requirements.

Ugly Error

Before You Report

  1. Give it ten minutes and experiment. Either you do it, or I do it. We have limited time on this planet, and I would rather spend it on actual development.

  2. Use common sense. Think for yourself.

Bad: Plugin don't work at all. Bosses are not spawned!

Good: I would like the Bosses to be spawned in my hardcore world only, however they do not spawn at all. I've configured the Natural Spawning in the menu, even restarted the server and ensured no errors occur, but it haven't worked. I am using Boss X.Y.Z and Spigot vX. Is there anything I could have done wrong there?

  1. Ensure no similar issue already exists. Use Search or 'CTRL + F'.

  2. Ensure the issue is actually caused by this plugin.

Keep in Mind

  • Any reloading (/reload, PlugMan, ..) may cause issues. Do a clean server restart first.
  • Never edit configuration files on a running server.
  • Shut down the server before installing or updating plugins. Do not reload.
  • Run the latest official version of Boss.
  • Run the newest Spigot for your server version (last 1.17.1, or last 1.8.8 build, etc.) and BuildTools.
  • Run the correct (usually latest) versions of dependencies (pay special attention to ProtocolLib, PowerNBT, Essentials or EssentialsX, and others)

What We Need to Know

  1. Your server version (if unsure, paste the content of /version command).
  2. How to reproduce. When does the bug occur?
  3. Any error logs or stack traces (this is critical).
  4. Is there any other plugins whose functions can interfere? PerWorldInventory/CreativeControl etc.?
  5. Include sections from your settings files that you have changed and believe might cause the issue.
Upload (the effective part of the) affected file(s) on pastebin.net