Skip to main content

Performance Configuration

Settings under performance: controlling throughput and load.

KeyTypeDefaultDescription
default-per-tick-limitint20Default blocks processed per server tick.
scan-thread-pool-sizeint4Number of threads used for block scanning.
dynamic-throttle.enabledbooleantrueAutomatically reduce performance limits when the server is lagging.
dynamic-throttle.tps-thresholddouble18.0TPS below which throttling activates.
dynamic-throttle.reduction-factordouble0.5Multiplier applied to limits while throttling is active.

Tuning: lower default-per-tick-limit/scan-thread-pool-size for small servers (e.g. 10/2); raise for large servers (e.g. 25/8).

Exampleโ€‹

performance:
default-per-tick-limit: 20
scan-thread-pool-size: 4
dynamic-throttle:
enabled: true
tps-threshold: 18.0
reduction-factor: 0.5

See Alsoโ€‹