# AetherLog v2 Configuration  
# Ultra-compact binary logging engine

# Object pool settings
pool:
  # Maximum number of reusable LogEntry objects in the global pool.
  # Higher values reduce GC pressure on busy servers at the cost of
  # slightly higher baseline memory (~200 bytes per entry).
  max-entries: 4096

# Buffer pool settings
buffer-pool:
  # Number of ByteBuffers kept in the pool for chunk batch writes.
  # Each buffer is reused instead of allocating new byte[] arrays.
  capacity: 32
  # Size of each buffer in bytes. Must be large enough for the biggest
  # chunk batch including embedded index, bloom, bitset, and time-range
  # sections (v4 format). 262144 (256KB) is recommended; the system will
  # fall back to heap allocation if a batch exceeds this size.
  buffer-size: 2048576 # 1MB
  # Use direct (off-heap) ByteBuffers. Default false; enable only if
  # profiling shows heap buffer copies to the mapped file bottleneck.
  direct: false

# Flush settings
flush:
  # Maximum entries in memory before forcing a disk flush
  threshold: 5000
  # Interval in seconds between automatic flushes
  interval-seconds: 300

# Jitter filter eliminates accidental place/break cycles
# (e.g., silk touch mining, building adjustments)
jitter:
  # Milliseconds within which a place→break or break→place pair is discarded
  window-ms: 15000
  # How often to purge expired jitter entries
  purge-interval-seconds: 30

# File handle cache
handles:
  # Maximum number of open chunk files to keep cached
  max-cache-size: 512
  # Idle time in minutes before closing a cached handle
  expire-minutes: 5

# Logging scope
logging:
  # Enable verbose diagnostic logging for debugging
  debug: false
  # Log block placements and breaks
  blocks: true
  # Log container inventory changes
  containers: true
  # Log fire spread / block burning
  fire: true
  # Log liquid (water/lava) flow
  liquid-flow: true
  # Log natural leaf decay
  leaves-decay: true
  # Log crop/plant growth (crops, sugarcane, cactus, saplings)
  crop-growth: true
  # Log block fade (ice melt, fire burn out, coral death)
  block-fade: true
  # Log entity block changes (enderman, silverfish, rabbits, etc.)
  entity-change: true
  # Log hanging entity placement (item frames, paintings)
  hanging-place: true
  # Log bucket empty/fill events
  bucket: true
  # Log player chat messages
  chat: true
  # Log player commands
  commands: true
  # Log player joins and quits
  sessions: true
  # Log items dropped by players
  item-drops: true
  # Log items picked up by players
  item-pickups: true
  # Log entity deaths caused by players
  entity-kills: true

# Purge settings
purge:
  # Number of days to retain logs (0 = disabled, keep forever)
  retention-days: 30
  # Interval in hours between purge scans
  interval-hours: 6

# Rollback settings
rollback:
  # Maximum radius in blocks for a single rollback command
  max-radius: 500
  # Maximum number of entries to process per lookup
  max-lookup-results: 10000

# Journal settings (CRIT-9 crash-safe rollback)
journal:
  # Enable journal files for crash-safe rollbacks.
  # When enabled, a .journal file is written before applying rollback
  # changes. If the server crashes mid-rollback, the journal is
  # detected on next startup and the partial rollback is reverted.
  enabled: false

# Storage backend: file (default) or mysql
storage:
  backend: file
  # Use atomic rename (temp file + move) for crash-safe chunk writes.
  # Disabling this gives slightly better write performance but risks
  # half-written files on power loss.
  atomic-rename: true
  # Verify CRC32 checksum footer on every chunk read.
  # Disabling this improves read performance but may allow corrupted
  # data to propagate.
  checksum-verification: true
  # Automatically rebuild index/bitset/bloom from chunk file when
  # corruption is detected. Requires checksum-verification to be enabled.
  auto-rebuild-index: true

# MySQL connection settings (only used when storage.backend = mysql)
mysql:
  host: localhost
  port: 3306
  database: aetherlog
  username: root
  password: ''
  # HikariCP connection pool settings (CRIT-7)
  pool-size: 10
  pool-min-idle: 2
  connection-timeout-ms: 30000
  idle-timeout-ms: 600000
  max-lifetime-ms: 1800000

# Web interface settings
web:
  # Enable the built-in web dashboard
  enabled: true
  # Port to listen on
  port: 8080
  # HTTP Basic Authentication credentials (HIGH-9)
  # Set both username and password to enable authentication.
  # Leave empty to run without auth (NOT recommended for public servers).
  username: ''
  password: ''