Skip to main content

Performance Configuration

Configure caching and async database behavior.

performance:
async-database: true
cache-size: 100
cache-expiration: 60
SettingTypeDefaultDescription
async-databaseBooleantrueRun database operations asynchronously to prevent server lag. Always enabled, cannot be disabled.
cache-sizeInteger100Number of orders cached in memory. Higher = better performance but more memory. Guidance: under 50 players โ†’ 100 (default); 50โ€“200 players โ†’ 200โ€“300; 200+ players โ†’ 500+.
cache-expirationInteger (seconds)60How long cached orders stay valid before refreshing from the database. Guidance: frequent updates โ†’ 30โ€“60s; normal usage โ†’ 60s (default); low activity โ†’ 120s+.

Troubleshootingโ€‹

SymptomCheck / Fix
Slow commands, GUI lag, TPS dropsIncrease cache-size, switch to MySQL (see Database Configuration), check server resources/other plugins
High memory usageReduce cache-size and/or cache-expiration

See Alsoโ€‹