Clearlag | Folia & Paper v1.0.3

# ╔══════════════════════════════════════════╗
# ║       SigmaClearLag  Configuration       ║
# ║   Folia-compatible lightweight clearlag  ║
# ╚══════════════════════════════════════════╝
# ── Schedule ───────────────────────────────────────────────────────────────────
schedule:
  interval: 300              # seconds between auto-cleanups  (minimum: 10)
  warnings: [3,2,1] # warn players this many seconds before cleanup
# ── Messages ───────────────────────────────────────────────────────────────────
# Supports &a &c &e &l etc. color codes.
#   {time}  → formatted time remaining, e.g. "1m 30s"  (warning only)
#   {count} → number of entities removed               (cleared only)
messages:
  warning: "&6⏳ &fEntities will be cleared in &e{time}&f!"
  cleared: "&a✔ &fCleared"
# ── Protection ─────────────────────────────────────────────────────────────────
# Entities matching ANY enabled rule are NEVER removed by anything below.
protection:
  named:        true   # any entity with a custom name tag
  tamed:        true   # tamed pets (wolves, cats, horses, parrots…)
  villagers:    true   # villagers and wandering traders
  armor_stands: true   # armor stands
  leashed:      true   # mobs currently on a leash
  ridden:       true   # any entity a player is actively riding
# ── Sweep ──────────────────────────────────────────────────────────────────────
# Fast server-wide pass that runs on every cleanup.
# Removes ALL matching entities in one go. Protection rules above always apply.
sweep:
  items:
    enabled: true
    # Item types that will NEVER be removed (Bukkit Material names, uppercase).
    whitelist:
      # - DIAMOND
      # - DIAMOND_BLOCK
      # - NETHERITE_INGOT
      # - NETHERITE_SCRAP
      # - NETHER_STAR
      # - ELYTRA
      # - TOTEM_OF_UNDYING
  xp_orbs:
    enabled: true
  projectiles:
    enabled: true
    # Projectile entity types that will NOT be removed.
    exclude:
      - TRIDENT
  mobs:
    enabled: false
    # Mob types that will NOT be removed by the sweep.
    exclude:
      - IRON_GOLEM
      - SNOW_GOLEM
      - WITHER
      - ENDER_DRAGON
      - ELDER_GUARDIAN
  # Removes empty (unoccupied) boats and minecarts.
  # Vehicles with a player riding them are always kept (see protection.ridden).
  vehicles:
    enabled: true
    # Vehicle types that will NOT be removed.
    exclude:
      - HOPPER_MINECART
      - MINECART
      - CHEST_MINECART
# ── Limits ─────────────────────────────────────────────────────────────────────
# Two-stage limiting system that runs AFTER the sweep above.
#
#  per_chunk  →  scans each loaded chunk; removes excess of any type locally
#  global     →  counts each type across the entire server; removes excess
#                starting from the most-crowded chunks
#
# Both stages can be used together (recommended) or independently.
limits:
  # Per-chunk limit — prevents pile-ups at grinders and spawner farms.
  per_chunk:
    enabled: true
    # Fallback limit for any mob type not listed under 'mobs' below.
    default_mob_max: 20
    total_max: 20
    # Per-type mob limits.  Types NOT listed here fall back to default_mob_max.
    mobs:
      # ZOMBIE:   10
      # SKELETON: 10
      # SPIDER:   8
      # CREEPER:  5
      # PHANTOM:  4
    # Per-type vehicle limits (boats, minecarts).
    # ONLY types listed here are capped — unlisted vehicles are left alone.
    vehicles:
      MINECART:        5
      CHEST_MINECART:  5
      HOPPER_MINECART: 5
      # OAK_BOAT: 5
    # Entity types skipped entirely by the chunk scanner (not counted, not removed).
    exclude:
      # - IRON_GOLEM
      # - SNOW_GOLEM
      - WITHER
      - ENDER_DRAGON
      - ELDER_GUARDIAN
    # Paper only — how many chunks to process per tick during the scan.
    # Ignored on Folia. Lower = smoother server; higher = faster cleanup.
    scan_chunks_per_tick: 20
  # Global limit — hard server-wide cap per entity type.
  # Runs AFTER per_chunk so local cleanup reduces density first.
  global:
    enabled: false
    # Entity types skipped by global enforcement.
    exclude:
      - IRON_GOLEM
      - SNOW_GOLEM
      - WITHER
      - ENDER_DRAGON
      - ELDER_GUARDIAN
    # Total cap across ALL worlds combined. Works for mobs and vehicles.
    caps:
      ZOMBIE:   300
      SKELETON: 200
      SPIDER:   150
      CREEPER:  100
      PHANTOM:   50
      SLIME:    100
      ENDERMAN: 100
      # MINECART: 50
      # OAK_BOAT: 30