FAQ

FAQ

Where are the reports saved?

plugins/connection-verify/connection/<number>.txt (or .json). Change the folder/format in Configuration.

I ran cnt <number> and it says "no connection found".

Connection numbers are kept in memory for the current server session, and are bounded by records.max-in-memory / records.expire-after-minutes. Save the report while the server is still running, and before the number is evicted.

A connection failed but got no number. Why?

Most failures are numbered, including nameless raw drops the server logs as /<ip>:<port> lost connection: … (caught by the logging.network-drops watcher). The only ones that cannot be numbered are handshakes closed so early that the server writes no log line at all — some incompatible-version cases close before anything is logged. If you do see a lost connection line with no number, make sure logging.network-drops and logging.failed-connections are enabled. See Connection Reports.

Does it work on Spigot/CraftBukkit?

No — it uses Paper-only APIs. Use Paper or a Paper fork (Purpur, etc.). See Compatibility.

Which jar do I download?

mc1.21 for Minecraft 1.21.4–1.21.x (Java 21+), mc26 for 26.x (Java 25+).

Does the plugin phone home / collect data?

No. Nothing leaves your machine unless you opt in to the update checker (update-checker.enabled: true), which only asks Modrinth whether a newer version exists — no server data is sent.

How do I protect player IPs?

Set privacy.mask-ip: true (and optionally privacy.hide-uuid: true). See Configuration.

Will saving a report lag my server?

No. With file.async-write: true (default) files are written off the main thread.

How do I change the language?

Set language and reload. See Languages.

Can I get JSON instead of text reports?

Yes — set file.format: json.

How do I report a bug or request a feature?

Open an issue: https://github.com/neramc/connection-verify/issues