Skip to main content

Reporting Issues

A good bug report is the first step to getting a bug fixed. By providing detailed and accurate information, you make it much easier for the developers to identify, reproduce, and solve the problem.

Before you post, please search the existing issues to see if someone has already reported the same problem.

How to Create a Bug Report​

All bug reports should be submitted to our GitHub Issue Tracker.

Follow these steps to create a high-quality report:

  1. Create a New Issue: Click the "New Issue" button on the issue tracker page.

  2. Write a Clear Title: Your title should be a brief, clear summary of the issue.

  • Bad Title: Mod doesn't work
  • Good Title: [Crash] Server crashes when a player with 1 life is killed by lightning
  1. Provide Essential Information: In the body of the issue, please include the following details. This is the most important part of your report.
  • X-Life Version: (e.g., 1.2)
  • Minecraft Version: (e.g., 1.20.1)
  • Mod Loader: Fabric or Forge, including its version number.
  • Full Mod List: A list of all other mods you have installed.
  • Server Logs / Crash Report: Copy the full crash report or the relevant section from your logs/latest.log file.
Use a Paste Service

For long logs or crash reports, please use a service like Pastebin, Gist, or mclo.gs and link to it in your issue. Do not paste huge walls of text directly into the issue description.

  1. Describe the Issue:
  • What happened? A clear description of the bug.
  • What did you expect to happen? What the correct behavior should have been.
  • Steps to Reproduce: Provide a precise, step-by-step list of actions to trigger the bug. This is critical for debugging.

A detailed report will lead to a much faster resolution. Thank you for helping improve X-Life!