> ## Documentation Index
> Fetch the complete documentation index at: https://ember.carr.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# Reporting bugs

> How to report a bug in Ember.

Ember is in early alpha. Bug reports are welcome and help shape the foundation.

## Where to report

File issues at [github.com/lukecarr/ember/issues](https://github.com/lukecarr/ember/issues).

Search the existing issues first to check that your report isn't already tracked.

## What to include

For most bugs, the maintainer needs:

* **Ember version**: run `/ember version` on your server and paste the output.
* **Server software and version**: Paper or Folia, plus the Minecraft version.
* **Java version**: the output of `java -version`.
* **Steps to reproduce**: the smallest sequence that triggers the bug.
* **Expected vs. actual behaviour**: what should happen, and what does happen.
* **Server log**: any stack traces from `logs/latest.log` around the time of the bug.

If the bug only appears with specific plugins installed, list them.

## Security issues

If you believe you've found a security issue, don't file a public issue. Use GitHub's private security advisory flow at [github.com/lukecarr/ember/security/advisories/new](https://github.com/lukecarr/ember/security/advisories/new) so the issue can be patched before disclosure.