# Report a Rust plugin bug the maintainer can reproduce

[Rust server guides](https://rustsc.com/learn/index.html.md) / [Troubleshooting](https://rustsc.com/learn/troubleshooting/index.html.md)

Tell the maintainer exactly what an ordinary player did and what they saw. ‘It broke after the update’ gives them a time. A minimal sequence and one working comparison give them something to repeat.

## Give the bug a narrow title

For example, ‘Member kit deducts points but grants no items after a restart.’ Name the plugin and its exact version, the Rust build, the framework version and any dependencies involved. Note whether you saw the same symptom with the author's unchanged release and your minimal settings on a test instance.

If the error only happens on one account, record the role or action history relevant to the issue. Use a synthetic account in the report. Give the maintainer the timing and exact first matching console error, without secrets or anyone's personal data.

## Give the maintainer a sequence they can follow

Use a cheap test kit and a small test balance.

1. Start the spare world and join with the test account in the member role.
2. Read the selected balance and leave an empty slot for the kit. Note the kit name and starting balance.
3. Restart the server cleanly, join again and make one claim. Record whether the item arrived and the balance changed.
4. Use another fresh account with the same access on a copy without the restart step. Note that result as the comparison. Say whether you reproduced the failure once or several times.

## Keep the report tied to one defect

Separate the expected result from the observed result. A helper who knows the game should be able to follow the report from a fresh test start. Put any unrelated compiler warning in its own investigation. Add a correction in the same thread if a later check changes the result.

## Sources

- [uMod maintainer guidance for reproducible reports](https://umod.org/documentation/reporting-issues)
- [Google SRE on hypothesis-driven troubleshooting](https://sre.google/sre-book/effective-troubleshooting/)

## Related resources

- [Reproduce a Rust plugin issue without sharing player data](https://rustsc.com/learn/configuration/check-per-player-rust-plugin-data-before-sharing-a-copy/index.html.md)
- [Read the first useful line in a Rust plugin compile error](https://rustsc.com/learn/troubleshooting/read-rust-plugin-compile-errors/index.html.md)

---

HTML version: https://rustsc.com/learn/troubleshooting/report-a-rust-plugin-error-the-maintainer-can-reproduce/
