Direct answer
Log every performance tweak with its exact setting, reason and measured outcome. A change log prevents repeated experiments and helps undo regressions after plugin upgrades or version changes.
Record these fields
- Timestamp, operator, Minecraft/server version, Java version and plugin/mod versions.
- Previous and new setting values, affected file path, whether the server was restarted and the backup/snapshot identifier.
- Test conditions: player count, active world, view/simulation distance, farm or chunk activity and measurement duration.
- Before/after
/spark tpsreadings and profiler report links; describe player-visible effects and any new errors.
Sample record
Change: Lower simulation-distance on test server
Reason: High entity tick cost under peak load
Before: value 10; 95th-percentile MSPT 41 ms
After: value 8; 95th-percentile MSPT 36 ms
Test: same players/world, similar activity
Outcome: Keep only if gameplay tradeoff is acceptableNumbers above are illustrative, not recommended settings or measured MSH results.
Version and safety notes
The sample metrics are deliberately fictional. Record real before/after measurements from the same server and avoid treating changed gameplay mechanics as a free optimization.
Review and rollback
If a tweak cannot be compared fairly, label the result inconclusive rather than claiming success. Preserve configuration diffs, avoid posting private report details publicly and revisit old changes after major software updates. Use a consistent format so more than one administrator can reproduce the test.
References
Check documentation for the versions and hosting environment you actually run.
Related guides
Help us improve this article
Tell us what is missing, unclear, outdated, or incorrect. You can also suggest something we should add.