########################################################
#                                                      #
#         ExtendedHorizons V2 Configuration            #
#                                                      #
#          Support the project starring it!            #
#     https://github.com/Mapacheee/ExtendedHorizons    #
#                                                      #
#   Join our Discord:  https://discord.gg/yA3vD2S8Zj   #
#                                                      #
########################################################

# Global view distance limits and defaults
# Note: The minimum distance is automatically set to the server's view-distance from server.properties
view-distance:
  max-distance: 64
  default-distance: 32

# Per-world settings (optional)
# If a world is not listed here, it will use the global settings above
# You can configure each world independently
world-settings:
  # Example: Limit view distance in the Nether
  # world_nether:
  #   enabled: true           # Enable/disable fake chunks for this world
  #   max-distance: 32        # Maximum view distance for this world
  
  # Example: Disable fake chunks in the End
  # world_the_end:
  #   enabled: false
  #   max-distance: 64

# Performance settings
performance:
  # Number of threads for parallel chunk processing (0 = auto-detect based on CPU cores)
  # Recommended: 0 (auto) or 4-8 for most servers
  chunk-processor-threads: 0
  # Interval in ticks between chunk validation/process cycles
  # Higher values reduce CPU usage but make loading "stuttery"
  chunk-process-interval: 1
  
  # Teleport warmup delay in milliseconds to load fake chunks
  teleport-warmup-delay: 10

  # MSPT Protection: Pause fake chunk loading if server is lagging
  max-mspt-for-loading: 40.0

  # Async Task Throttling: Limit concurrent chunk loading tasks
  max-async-load-tasks: 4
  max-async-load-queue: 10

  # Generation Limiter: Strict limit on chunks generated per tick
  max-generations-per-tick: 1

  # Fake chunks system (packets cache)
  fake-chunks:
    # Enable packet cache system
    enabled: true
    # Maximum cached packets (5000 = ~150MB)
    max-cached-packets: 5000
    # Enable GZIP compression for packets (slower but saves RAM)
    use-compression: false
    # Cache cleanup interval in seconds
    cache-cleanup-interval: 10
    # Enable chunk memory cache (reuses loaded chunks, saves CPU but uses RAM)
    # Recommended: true for <50 players, false for >100 players or low RAM servers
    enable-memory-cache: false
    # Maximum chunks to cache in memory (1000 = ~40-80MB depending on chunk complexity)
    # Increase for more players in same area, decrease for dispersed players or low RAM
    max-memory-cache-size: 1000
    # Packet cache TTL in seconds
    packet-cache-ttl-seconds: 30

    # Enable this feature will affect the speed to load fake chunks
    # enable this only if its necessary
    anti-xray:
      # Enable anti-xray obfuscation for fake chunks
      enabled: false
      # Replace valuable ores with stone/deepslate
      hide-ores: true
      # Add fake ores to confuse x-ray users
      add-fake-ores: true
      # Density of fake ores (0.0-1.0, higher = more fakes)
      fake-ore-density: 0.15
  
  # Occlusion Culling: Prevents sending hidden chunks to save bandwidth/FpS
  occlusion-culling:
    # Enable occlusion culling (recommended: true)
    enabled: true
    # Chunks below this sky light level may be culled (hidden)
    # 0 = nothing culled based on light, 15 = strict
    sky-light-threshold: 14
    # Maximum Y level to cull (usually matches server max height)
    max-y-level: 320
    # Minimum Y level to cull (usually matches server min height)
    min-y-level: -64

# Bandwidth Saver settings
bandwidth-saver:
  enabled: true
  # Skips redundant entity movement/rotation packets (ESU-inspired)
  skip-redundant-packets: true
  # Limits the rate of fake chunk sending to prevent network saturation
  max-fake-chunks-per-tick: 20
  # Maximum bandwidth per player in KB/s (512 KB/s = ~4 Mbps)
  # Set to 0 to disable bandwidth limiting
  max-bandwidth-per-player: 10000
  # Enable adaptive rate limiting based on player ping
  # Reduces packet rate for high-ping players to prevent packet loss
  adaptive-rate-limiting: true
  # Use real packet size measurement (slightly more CPU, very accurate)
  # Recommended: true for accurate bandwidth tracking
  measure-actual-packet-size: true
  # Fallback estimate if measurement disabled (in bytes)
  # Average chunk packet is ~50KB (mountains can be 100KB+)
  estimated-packet-size: 50000

# Database (SQLite) used for player view persistence
database:
  enabled: true
  file-name: "extendedhorizons"

integrations:
  placeholderapi:
    enabled: true
  luckperms:
    enabled: true
    check-interval: 60 # seconds
    use-group-permissions: true

# Message toggles (actual texts live in messages.yml)
messages:
  welcome-message:
    enabled: false