Reporting bugs¶
Reporting discovered bugs helps Mineclonia developers and contributors reproduce and fix problems with the game. Bug reports go to the Mineclonia issue tracker, but it’s fine to discuss them on the Mineclonia Discord too.
You should report a bug when Mineclonia behaves in an unexpected way that can be reproduced (repeated), such as a crash, a broken interaction, incorrect visuals or gameplay behavior, an error message appearing in chat, etc.
Filing an issue¶
First, you should check whether the bug you’re trying to report had already been reported.
Go on the Mineclonia Codeberg and open the Issues tab.
In the top field saying Search issues…, try searching for keywords that would relate to your bug. Examples:
general topic (moobloom, breeding, breeding crash);
device or platform (android, macos);
parts of error messages (attempt to perform arithmetic on a string value, attempt to compare number with nil).
Skim through the top results, esp. ones with potentially related titles.
If it appears that you’re the first one to discover (or at least report) the bug, proceed with filing the report.
Click or tap the New issue button.
Write a clear title that describes the problem. Prefer “Game crash when breeding mooblooms” over an ominous “I need help”.
Describe the bug and what’s needed to reproduce it. Include:
what you were doing when the bug happened;
what you expected to happen;
what actually happened;
any error messages from chat or from the Luanti crash dialog;
your device type and operating system, such as
Desktop (Windows 11)orMobile (Android 13);any files that may explain the issue, such as a screenshot or a world download.
Once everything is ready, click or tap Create issue.
A good report lets someone else repeat the problem. If you can only trigger the bug when certain things happen, lay them out. If you ran into multiple issues at once, it’s better to file issue reports for them separately.