Support

Where to ask

Discord — Config questions, quick help, release announcements.
GitHub issues — Reproducible bugs, crashes and feature requests.

Both channels are read by the same person. Discord is faster for questions, GitHub is better for anything that needs a fix.

Before you report

Update first

Reproduce the issue on the latest release. A large share of reports are bugs that were fixed weeks ago.

Test in isolation

Start a clean server with only the plugin and its dependencies. If the issue disappears, it is a conflict — tell us which plugin brings it back.

Collect the evidence

Run the built-in dump command and attach the resulting file:


/aqua debug dump

It writes plugins/AquaCore/debug/dump-<timestamp>.txt with the server version, Java version, plugin list, active modules and the last 200 plugin log lines. It contains no IPs and no player data.

A good report


**Plugin version:** AquaCore 2.0.0
**Server:** Paper 1.21.4 (build 232), Java 21
**Other plugins:** PlaceholderAPI 2.11.6, LuckPerms 5.4.141
 
**Expected:** /aqua broadcast welcome sends the title
**Actual:** chat line is sent, title never appears
 
**Steps:**
1. Set `titles.enabled: true` in templates/welcome.yml
2. Run /aqua broadcast welcome player(Senkex)
3. Chat line shows, no title
 
**Console:** (attached dump-2026-08-30.txt)

Reports with no version, no console output and no reproduction steps get closed. It is not rudeness — there is genuinely nothing to work with.

What is not supported

Cracked or “custom” builds of the plugins.
Servers running Minecraft below 1.16 or Java below 17.
Modified jars, including decompiled and recompiled ones.
Config files edited into invalid YAML — run them through a linter first.