ClearLAGG

Clearlagg

Prevention, not brute force.

Full control over every source of entity, spawner, TNT and redstone lag on your server — lightweight, fully configurable down to the last message, and built to disappear from your timings report.

✨ Features

📦 Dependencies

• Paper 1.21.x — required — papermc.io
• PlaceholderAPI — optional — Modrinth

🔧 How It Works

Clearlagg doesn't wait for your server to already be lagging — every limiter runs at the point of creation: a spawner placement, a bred animal, a primed TNT, a spawned item. If it would exceed your configured limit, it's stopped or removed immediately, instead of building up until a scheduled clear has to nuke half your world's entities at once.

On top of that, a periodic scan sweeps loaded chunks for the entity-limiter and refreshes "never despawn" items, while the TPS/RAM meter watches server health continuously and can fire your own console commands the moment a threshold is crossed — including running /lagg clear automatically under critical load.

Halt mode gives you an emergency lever: instantly suspend the systems you choose (mob spawning, hopper transfer, redstone, fluid flow, item merging) with one command, and resume just as fast.

⚙️ Configuration

# =====================================================================
#                       Clearlagg Configuration
#   Full control over every module. Disable anything you don't need -
#   Clearlagg only activates the systems you enable, so it stays
#   extremely lightweight on a stock configuration.
# =====================================================================

settings:
  prefix: "&8[&bClearlagg&8] &7"
  language: "english"   # english, german, french, spanish, russian, polish,
                         # czech, japanese, korean, brazilianportuguese,
                         # chinesesimplified, chinesetraditional
  startup-banner: true
  clean-logs-on-startup:
    enabled: false
    older-than-days: 14

entity-clear:
  enabled: true
  auto-clear-interval: 600
  warn-before-clear:
    enabled: true
    warn-seconds-before: 10
  excluded-worlds: []
  entities:
    DROPPED_ITEM: true
    ARROW: true
    EGG: true
    SNOWBALL: true
  ignore-named-entities: true
  ignore-leashed-entities: true
  ignore-tamed-entities: true

limiters:
  enabled: true
  scan-interval-ticks: 100
  entity-limiter:
    enabled: true
    per-chunk-limits:
      DROPPED_ITEM: 40
      ARROW: 20
    default-limit: -1
  mob-limiter:
    enabled: true
    per-chunk-limit: 25
    prevent-spawns-at-limit: true

tnt:
  enabled: true
  max-primed-per-chunk: 25
  chain-reaction-radius-limit: 0
  max-blocks-per-explosion: 500
  disable-block-damage: false

halt:
  enabled: true
  disable:
    mob-spawning: true
    hopper-transfer: true
    redstone: false
    fluid-flow: false
    item-merging: false

commands:
  confirm-destructive-commands: true
  confirmation-window-seconds: 10
  destructive-commands: ["clear", "killmobs", "area", "unloadchunks", "gc"]

# ... every module (spawner-limiter, mob-egg-limiter, breeding-limiter,
# item-livetime, chunk-analysis, chunk-unloader, ai-limiter, tps-meter,
# gc-monitor, tick-sampler, memory-sampler, profiler) has its own fully
# documented section in config.yml — nothing is hardcoded.

🔑 Commands

📋 Placeholders

Requires PlaceholderAPI to be installed.

👥 Credits

Discord: dc.gg/paperstream