Production Quickstart

The default thresholds in config.yml are intentionally low to ensure visible plugin activity on small or test servers. On a production server these values will cause constant, unnecessary interventions. Adjust to the following ranges after reviewing the Analysis mode report.

# config.yml — heuristics.triggers section
heuristics:
  triggers:
    # Entity thresholds
    entity-count: 400          # Demo value: 80
    passive-mob-count: 200     # Demo value: 40
    entity-hotspot: 150        # Demo value: 35 (per chunk)
    tile-entity-count: 20000   # Demo value: 1000

    # Chunk thresholds
    loaded-chunks: 8000        # Demo value: 450
    simulated-chunks: 4000     # Demo value: 220
    forced-chunks: 300         # Demo value: 60
    chunk-entity-hotspot: 80   # Demo value: 30

    # Redstone and mechanics
    redstone-updates: 10000    # Demo value: 500
    piston-activations: 2000   # Demo value: 100

  engine:
    cooldown-min-seconds: 20   # Demo value: 12
    cooldown-max-seconds: 300  # Demo value: 180

Important: Not adjusting these thresholds before opening a production server to players is the most common cause of unnecessary TPS interventions and player experience complaints. Always run Analysis mode first to establish your server's normal operating range.