Chorus Clear Lag

Chorus Clear Lag

Smart, fully customizable lag cleaner for Paper servers.
Clean up dropped items and entities on a schedule without deleting what your players care about. Every message is editable, hex colors are supported everywhere, and the default look is purple.

By Controll3r24

Why Chorus Clear Lag?

Classic clear-lag plugins get the same complaints again and again: diamonds and enchanted gear vanishing, pets and named mobs deleted, holograms and item frames wiped, items lost right as the timer fires, chat spam, no per-world control. Chorus Clear Lag was built around fixing exactly those problems.

Common complaint · How Chorus Clear Lag handles it
Valuable items get deleted · Protected materials with wildcards, enchanted / named / lore items are kept, shulker boxes and netherite are protected by default
Items disappear the moment they drop · Minimum item age before an item can be cleared
Death drops get wiped · Player death drops are protected for a configurable time
"Oops, I lost my stuff" · Item recovery: restore the last cleanups with /ccl restore
Pets, named mobs and villagers deleted · Named, tamed, leashed, riding, boss and configurable mob types are always safe, plus mobs near players
Holograms, item frames, armor stands, paintings, displays · Never touched: only the entity categories you enable are scanned
Passenger boats and minecarts removed · Only empty vehicles are cleared, named vehicles are kept
Chat spam · Chat, action bar, title and boss bar are toggleable, and every player can hide announcements with /ccl mute
No per-world control · Blacklist or whitelist worlds
Not enough control over messages · Every single message lives in messages.yml and can be disabled by leaving it empty

Features

• Automatic cleanup on a configurable interval with a custom list of warning times
• Warnings through chat, action bar, title and boss bar countdown, with sounds
• Clears items, hostile mobs, passive mobs, XP orbs, projectiles, falling blocks, primed TNT and empty vehicles (each one optional)
• Smart protection for items and mobs, plus a scoreboard tag (chorus_keep) to protect any entity
• Item recovery with history and expiry
• Optional TPS trigger: starts an emergency cleanup countdown when TPS drops under your threshold
• Optional per-chunk entity limiter that removes only the oldest unprotected entities above the limit
• Entity check per world, busiest chunk finder, TPS / MSPT / memory overview, cleanup statistics
• Minimum online players setting, so empty servers are not scanned for nothing
• Fully customizable messages with hex colors

Colors

All messages support:

• Hex colors: &#a855f7, #a855f7 or ``
• Classic color and format codes: &l, &o, &r and so on

Default palette: #a855f7 #c084fc #d8b4fe #e9d5ff #7c3aed.

Commands

Aliases: /ccl, /chorusclear, /clearlag

Command · Description · Permission
/ccl help · Show the command list · chorusclearlag.help
/ccl clear [category] [world] · Run a cleanup now (auto, all, mobs, items, hostile, passive, xp, projectiles, falling, tnt, vehicles) · chorusclearlag.clear
/ccl check [world] · Count entities and how many are removable · chorusclearlag.check
/ccl chunks [amount] · Show the chunks with the most entities · chorusclearlag.chunks
/ccl tps · TPS, MSPT, memory, entities and chunks · chorusclearlag.tps
/ccl next · Time until the next cleanup · chorusclearlag.next
/ccl stats · Cleanup statistics · chorusclearlag.stats
/ccl toggle · Enable or disable automatic cleanups · chorusclearlag.toggle
/ccl mute · Hide cleanup announcements for yourself · chorusclearlag.mute
/ccl restore [list\ · batch] [radius] · Bring back items removed by recent cleanups · chorusclearlag.restore
/ccl reload · Reload config and messages · chorusclearlag.reload

chorusclearlag.admin grants everything. help, next, mute and tps are enabled for everyone by default.

Configuration

Two files are generated in plugins/ChorusClearLag/:

• config.yml: intervals, warnings, announcements, sounds, worlds, what gets cleared, protections, recovery, chunk limiter and TPS trigger
• messages.yml: every message, with placeholders like {time}, {total}, {items}, {hostile}, {passive}, {xp}, {projectiles} and {protected}

Set any message to "" to disable it.

To keep a specific entity forever, give it the scoreboard tag:

/tag @e[type=minecraft:armor_stand,limit=1,sort=nearest] add chorus_keep

Installation

1. Stop your server
2. Drop ChorusClearLag-1.0.0.jar into plugins/
3. Start the server and edit plugins/ChorusClearLag/config.yml and messages.yml
4. Use /ccl reload to apply changes

Compatibility

• Paper and Paper forks (Purpur, Pufferfish and similar)
• Minecraft 1.21.4 up to 26.2
• Java 21 or newer (Minecraft 26.1+ servers run on Java 25)
• Folia is not supported

FAQ

Will it delete my villagers or pets?
No. Villagers are never scanned, and tamed, named, leashed and riding mobs are protected even when mob clearing is enabled. Mob clearing is disabled by default.

Can I get my items back after a cleanup?
Yes. Use /ccl restore list to see recoverable cleanups and /ccl restore to put the latest one back where the items were. Use /ccl restore 1 20 to restore only items within 20 blocks of you.

Does a manual clear respect protections?
Yes. Manual and automatic cleanups use exactly the same protection rules.

Can I hide the announcements?
Players can use /ccl mute. Admins can disable any announcement type in config.yml.

Made with love by Controll3r24