Skip to main content

Performance & Optimization

Features​

  • Async operations - block operations run off the main thread, preserving TPS.
  • Per-tick limits - caps blocks processed per server tick, configurable per tool.
  • Dynamic throttling - monitors server TPS and automatically reduces limits when lagging.
  • Queue management - global and per-player queue caps prevent memory issues.

Configuration​

tools:
  pickaxe:
    per-tick-limit: 20       # blocks per tick
    max-blocks-per-use: 80

general:
  global-concurrent-cap: 50      # max concurrent operations
  max-global-queue-size: 1000
  max-player-queue-size: 100

performance:
  dynamic-throttle:
    enabled: true
    tps-threshold: 18.0     # start throttling below this TPS
    reduction-factor: 0.5   # reduce to 50% when throttling

Scale global-concurrent-cap, max-global-queue-size, per-tick-limit, and max-blocks-per-use up for larger player counts; start conservative and raise gradually while watching TPS.

Monitoring​

/sigmatools debug queue
/sigmatools debug ops
debug:
  performance: true

See Also​