# ==================================================
# HydroLiteChunks Configuration
# Developer: TheMeanOneDevelopments
# Discord: https://discord.gg/SnjXeK7hVz
#
# This plugin optimizes server performance by
# intelligently unloading chunks with safety features.
#
# NOTE: All values can be tweaked live with /hydrolite reload
# ==================================================


# ==================================================
# Interval Settings
# ==================================================

# How often HydroLiteChunks should run a cleanup cycle.
# Measured in TICKS (20 ticks = 1 second).
# Default: 600 (30 seconds).
unload-interval : 600


# ==================================================
# Player Radius Settings
# ==================================================

# Base chunk radius to keep loaded around each player.
# Example: 6 = 6 chunks * 16 blocks = 96 blocks radius.
base-radius : 6

# Dynamic scaling of radius based on server TPS.
dynamic-radius:
  enabled : true             # Enable/disable dynamic scaling.
  high-tps-threshold : 19.5 # If TPS is >= this, radius increases.
  low-tps-threshold : 16.0   # If TPS is <= this, radius decreases.
  adjustment : 2             # Number of chunks to add/remove.


# ==================================================
# Chunk Aging
# ==================================================

# Minimum age (in cycles) before a chunk can be unloaded.
# Prevents constant unloading/reloading of "hot" chunks.
# Example: If set to 3, chunk must survive 3 full scans
#          before eligible for unload.
min-chunk-age : 3


# ==================================================
# World Control
# ==================================================

worlds :
  # Mode can be:
  #   whitelist -> Only unload chunks in these worlds.
  #   blacklist -> Unload chunks in all worlds EXCEPT these.
  mode : whitelist

  # List of worlds to include/exclude depending on mode.
  list :
   - world
    - world_nether
    # - world_the_end


# ==================================================
# Logging and Broadcasting
# ==================================================

logging :
  # Log every unload to console.
  log-unloads : true

  # Broadcast unload results to ALL players.
  broadcast-unloads : false

  # Message format when broadcasting (uses placeholders):
  #   {count}  = number of chunks unloaded
  #   {memory} = approx MB freed
  broadcast-format : "&b[HydroLiteChunks]&7 Unloaded &e{count}&7 chunks (~{memory} MB)!"


# ==================================================
# Safety Features
# ==================================================

safety :
  # Maximum chunks that can be unloaded per cycle.
  # Prevents lag spikes if thousands of chunks are loaded.
  max-unload-per-cycle : 500

  # Pause/suspend aggressive unloads if TPS is too low.
  tps-aware-interval : true
  tps-threshold : 15.0


# ==================================================
# Hooks
# ==================================================

hooks :
  # WorldGuard support:
  #   Skip unloading chunks if inside a protected region.
  worldguard : false   # Set to true if using

  # Essentials support:
  #   Skip unloading the spawn chunk.
  essentials-spawn : false # Set to true if using

  # Dynmap support:
  #   Marks unloaded chunks on Dynmap using markers.
  dynmap : false # Set to true if using


# ==================================================
# Metrics
# ==================================================

# Enable bStats metrics (anonymous usage statistics).
metrics : true