Skip to main content

Performance Configuration

Complete reference for performance settings.

Configuration Location​

performance:
  # Settings here

Settings Reference​

Default Per-Tick Limit​

Path: performance.default-per-tick-limit
Type: int
Default: 20
Description: Default blocks processed per server tick

performance:
  default-per-tick-limit: 20

Scan Thread Pool Size​

Path: performance.scan-thread-pool-size
Type: int
Default: 4
Description: Number of threads for block scanning

performance:
  scan-thread-pool-size: 4

Dynamic Throttling​

Path: performance.dynamic-throttle
Type: section
Description: Automatic performance reduction when server is lagging

performance:
  dynamic-throttle:
    enabled: true
    tps-threshold: 18.0
    reduction-factor: 0.5

Settings:

  • enabled - Enable dynamic throttling (default: true)
  • tps-threshold - TPS threshold to start throttling (default: 18.0)
  • reduction-factor - Performance reduction factor (default: 0.5)

Complete Example​

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

Performance Tuning​

For Small Servers​

performance:
  default-per-tick-limit: 10
  scan-thread-pool-size: 2

For Large Servers​

performance:
  default-per-tick-limit: 25
  scan-thread-pool-size: 8

Next Steps​