Bug Reporting

From MinecraftOnline
Jump to navigation Jump to search
A literal bug

MinecraftOnline has a great number of modifications over the vanilla Minecraft server, and as such maintains a large custom codebase. Occasionally, as with any code, bugs crop up. To make the process of locating these bugs and fixing them easier, MinecraftOnline maintains a list of bug trackers for each component of its software.

Known Bugs With Workarounds

Client bugs:

  • Invisible ("ghost") blocks - workaround: relog. Alternately use the AntiGhost mod.
  • Disappearing paintings - workaround: relog.
  • Unloaded skins - workaround: relog. (Fixed?)
  • Invisible players - workaround: ask the other player to relog.
  • Rendering bugs - tunnels and similar might be visible when moving fast or moving into and out of certain areas in darkness - see image below for a screenshot of a underground railway without any client mods and on a fast computer. Workaround: change the rendering distance, forcing nearer chunks to reload first.
  • Zombie state - caused by healing when already dead, putting the player in a state where they cannot pick up any items or wear armour. Workaround: relog, or in extreme cases, delete the player file to force it to reinitialise.
  • World holes - Missing chunks in the world which the affected player cannot cross - workaround: relog, report chunk errors if it still doesn’t load.
  • Elytra not opening - an elytra taking its time to open on takeoff is almost always the case when the server tps is low - workaround: Elytra Fix

Server bugs:

  • Cumulative java memory leaks - workaround: periodic restarts using !stop command in IRC.
  • Silent write fails, resulting in chunk corruption when saving - workaround: ensure sufficient disk space exists at all times.
  • Running out of memory causes catastrophic crashes - workaround: ensure sufficient swap is allocated at all times to cope with memory leaks.
  • Running out of file handles for network connections and open files - workaround: ensure user hard and soft limits are at the max with ulimit -HSn 65536, and the appropriate maximum limit in /etc/security/limits.conf. Alternative workaround: run the server as root (not recommended!)

Bug Gallery

The issue tracker

The developers of MinecraftOnline encourage players to report any and all bugs they encounter. To encourage timely reporting of bugs, vote tokens will be award to bugs players find based on the bug's severity.

Before you report a bug, search on the GitLab issue tracker to make sure it has not already been reported. If you see that a bug report for your issue already exists, it is encouraged that you provide any new information you can for it.

Next, please make sure you are actually reporting a bug. Suggestions about server builds like spawn and the rules hall, and problems with wiki pages do not belong on the bug tracker. If you have concerns like those, please send an email with your thoughts to feedback@minecraft.com instead. Similarly, we do not accept bugs involving your client, unless you suspect these issues being caused by the server (for example, texture glitches in Optifine are client-side.) If you are unsure, make the bug report and allow the developers to make that determination. They don't bite!

How to report bugs

To report a bug, please post in the catch-all issue tracker or if the correct issue tracker listed below if you know what is causing the bug, making sure to include all relevant details:

  • Your in-game username (if not the same username on bug tracking site)
  • What you were trying to do at the time
  • What you expected to happen
  • What did happen
  • Any error messages received, in full
  • One or more screenshots, if possible
  • Whether the problem recurs, or was a one-off
  • What steps you can take to reproduce the problem

You can use the template Mojang uses for their issue tracking if you would like. Here are some excellent bug reporting examples from Mojang's issue tracker.


Using labels, each issue can be set to a priority, please mark them appropriately following these guidelines:

  • blocker: the server cannot run without fixing this, it can't even start
  • critical: this causes the server to crash, or to be completely unplayable in one way or another
  • major: negatively affects the player experience for an appreciable number of players
  • minor: affects some player experience some of the time, but not all the time or not all players
  • trivial: if this was never fixed, most people would never even notice

Please include any other labels you think are relevant. A developer will double-check your work, so don't be too concerned about getting it right.

After the report

A developer will try to confirm an issue after it is reported. Then it will be moved to the specific project that the bug involves. When the developers finds out that it is a bug, a Confirmed label will be added onto the issue. It is at this point that you will be awarded vote tokens if applicable.Please watch your issue to see if the developer handling it or other users ask you questions! Many minor bugs will not be immediately prioritized, so don't be surprised if fixing the bug takes some time.

Bug trackers




The following specific bug trackers are available for issues connected with individual plugin components. If you know what component your bug is caused by, please post directly on the issue tracker for that component below. Otherwise, use the catch-all issue tracker above.


Internal Administration

The following bug trackers are for internal administration; you are unlikely to encounter bugs with them directly but they are listed here for completeness:


If a bug is not associated with any specific plugins or exec extensions, but does not occur in vanilla, it may be a bug in Sponge. Reporting issues here should be considered a last resort, unless a developer is confident that it really is Sponge at fault.