ClearLag

ClearLagg automatically removes lag-causing entities while keeping players, protected mobs, and plugin-managed entities safe. Everything is configurable and can be reloaded in-game.

• ⏱️ Automatic cleanup — enable or disable it and set the interval
• 📢 Customizable warnings before each cleanup
• 🎯 Entity categories — items, projectiles, experience orbs, boats, minecarts, item frames, paintings, primed TNT, and mobs
• 🛡️ Player protection — players are never removed
• 🐾 Targeted mob rules by entity type and custom name
• 👑 MythicMobs support — protect custom mobs by their internal IDs
• 📍 Area cleanup within a radius around the player
• 🌍 Current-world or all-world cleanup
• 🧩 ItemsAdder protection during cleanups, with an option to include them in area cleanups
• 🔌 Third-party entity protection through plugin namespaces
• 🔄 Hot reload for config.yml and lang.yml, without restarting the server
• 💬 Customizable messages with hex colors, gradients, and bold text

---

Main command: /clearlagg (alias: /lagg)

Command	Description	Permission
/clearlagg / /clearlagg help	Show the help menu	clearlag.command
/clearlagg time	Check the time remaining until the next automatic cleanup	clearlag.time
/clearlagg clear	Clean configured entities in the current world	clearlag.clear
/clearlagg clearall	Clean configured entities in all worlds	clearlag.clearall
/clearlagg area <radius> [-ia]	Clean entities around you; -ia includes ItemsAdder entities	clearlag.area
/clearlagg reload	Reload the configuration, messages, and integrations	clearlag.reload

clear and area are player-only commands. clearall, time, and reload can also be run from the console.

---

Permission	Description	Default
clearlag.*	Access to all ClearLagg commands	op
clearlag.command	Access to the main command	true
clearlag.admin	Receive update notifications	op
clearlag.time	Check the time until the next cleanup	true
clearlag.clear	Clean the current world	op
clearlag.clearall	Clean all worlds	op
clearlag.area	Clean entities within a radius	op
clearlag.reload	Reload the plugin	op

Access to /clearlagg also requires clearlag.command; each subcommand checks its own permission as well.

---

The config.yml and lang.yml files are created in the plugin's data folder.

Automatic cleanup

auto-removal:
  enabled: true
  autoremoval-interval: 600
  warnings:
    - "time:300"
    - "time:60"
    - "time:30"
    - "time:10"
    - "time:5"

  item: true
  projectile: true
  experience-orb: false
  boat: false
  minecart: false
  itemframe: false
  painting: false
  primed-tnt: false
  mob: false

Each warning must be lower than the cleanup interval. Invalid entries are skipped and reported in the console.

Mob exclusions

These protections only apply to mobs and are enabled by default except for named mobs:

auto-removal:
  mob-exclusions:
    armor-stands: true
    villagers: true
    tamed-animals: true
    leashed: true
    mounted: true
    named: false

Mob rules

mob-rules uses an explicit action. protect rules prevent removal, while remove rules target a mob type even when the mob category is disabled.

mob-rules:
  - type: "LLAMA"
    action: "protect"
    custom-name-contains: "PINATA"
  - type: "ZOMBIE"
    action: "remove"

Available filters:

• custom-name — exact name, or "*" to match any custom name
• custom-name-contains — matches any name containing the given text

The legacy protected-mobs format is still read for compatibility: a type alone removes the mob, while a type with a name protects it.

Third-party entity protection

Some plugins mark their entities with a custom namespace. Add those namespaces below so ClearLagg never removes them:

protected-namespaces:
  - "example-plugin"
  - "mycustomplugin"

The values above are examples: use the namespace of the plugin that owns the entities you want to keep. Any entity carrying data from a listed namespace is skipped, regardless of the enabled categories.

Area cleanup

area:
  max-radius: 500

/clearlagg area <radius> is capped by this value, and the radius must be a valid positive number.

Update checker

update-checker:
  enabled: true
  project-id: "clearlagg"
  notify-console: true
  notify-on-join: true

project-id is the Modrinth project slug. Join notifications are only sent to players with clearlag.admin.

Messages

In lang.yml, customize every in-game message. Hex colors (&#RRGGBB), gradients (<gradient:#FF0000:#FF3333>text</gradient>), and bold tags (<bold>text</bold>) are supported.

Use /clearlagg reload to apply changes without restarting the server.

---

• ItemsAdder — its entities are protected from cleanups by default. Use /clearlagg area <radius> -ia to include them in an area cleanup.
• MythicMobs — protect custom mobs by adding their internal IDs to mythicmobs.protected-mobs:

mythicmobs:
  protected-mobs:
    - "ExampleBoss"

---

Compatibility

• Paper or Spigot 1.21+
• Java 17+
• All integrations are optional; the plugin works without them.