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

  1. Timestamp, operator, Minecraft/server version, Java version and plugin/mod versions.
  2. Previous and new setting values, affected file path, whether the server was restarted and the backup/snapshot identifier.
  3. Test conditions: player count, active world, view/simulation distance, farm or chunk activity and measurement duration.
  4. Before/after /spark tps readings 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 acceptable

Numbers 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.

Was this article helpful?
Help us improve this article

Tell us what is missing, unclear, outdated, or incorrect. You can also suggest something we should add.

What could we improve?
Do not include passwords, server IPs, or other private information.0 / 1000