Skip to main content

Prepare a useful ViaVersion support report without leaking configuration

Applies to: ViaVersion; match the linked maintainer documentation to your installed platform and release.
Documentation checked .

A useful compatibility report explains which client, server and translation path failed. A screenshot of a disconnect message rarely supplies enough context. Conversely, posting an entire panel archive can expose unrelated credentials. Build a small report that a maintainer can reproduce without accessing your service.

Record the starting point

Write down the server platform and build, Java version, ViaVersion family releases and affected client version. Identify whether the client connects through a proxy. Keep the original error locally, including its timestamp, and separate account or address information from the technical reproduction.

Work through the change

  1. Reproduce the issue using one short sequence of actions. Include the expected behaviour, actual result and whether the native server client behaves differently.
  2. Use the diagnostic or dump facility documented for your installed ViaVersion release if support requests it. Read the output before sharing its link; generated reports may expose plugin and network details.
  3. Add only the relevant startup or disconnect excerpt. Redact passwords, tokens and unrelated player information without removing version numbers or the first error in the stack trace.
  4. Check the maintainer's issue template and search for the same server/client combination. Submit one report with the minimal reproduction instead of multiple reports containing different guesses.

Check the result

A reader should be able to identify the protocol direction, components involved and exact failing action. Keep a private copy of the report and its original logs so staff can answer a follow-up without asking the player to repeat the failure repeatedly.

If the result differs

If the reproduction disappears after removing a packet-dependent plugin on a test copy, include that comparison. It does not prove either maintainer is at fault, but it narrows the interaction. If no clean reproduction exists, say which observations are confirmed and which remain uncertain.

Remove a public diagnostic link where the hosting tool allows it if you discover a secret after sharing. Rotate an exposed credential rather than assuming deletion removed every copy. Keep gameplay configuration unchanged while preparing the report.

References and related help