Chorus Clear Lag
专为 Paper 服务器设计的智能、完全可定制的延迟清理工具。
按预定计划清除掉落的物品和实体,同时不会删除玩家珍视的内容。所有消息均可编辑,支持全平台十六进制颜色代码,默认外观为紫色。
由 Controll3r24 制作
为什么选择 Chorus Clear Lag?
传统的清延迟插件总是面临相同的抱怨:钻石和附魔装备消失,宠物和命名生物被删除,全息图和物品展示框被抹除,计时器触发时物品丢失,聊天刷屏,且缺乏世界级别的管控。Chorus Clear Lag 正是为解决这些问题而构建的。
| 常见抱怨 |
Chorus Clear Lag 的处理方式 |
| 贵重物品被删除 |
受保护的材料支持通配符,附魔/命名/有描述的物品会被保留,潜影盒和下界合金默认受保护 |
| 物品刚掉落就消失 |
设置物品在可被清除前的最小存在时间 |
| 死亡掉落被清除 |
玩家死亡掉落物会在可配置的时间内受到保护 |
| “哎呀,我的东西丢了” |
物品恢复功能:通过 /ccl restore 恢复最近的清理记录 |
| 宠物、命名生物和村民被删除 |
命名、驯服、拴绳、骑乘、Boss 以及可配置的生物类型始终安全,靠近玩家的生物也会受到保护 |
| 全息图、物品展示框、盔甲架、画作、显示实体 |
完全不受影响:仅扫描你启用的实体类别 |
| 乘客乘坐的船只和矿车被移除 |
仅清除空载车辆,命名车辆会被保留 |
| 聊天刷屏 |
聊天、操作栏、标题和 Boss 栏均可切换开关,每位玩家都可以通过 /ccl mute 隐藏公告 |
| 缺乏世界级别的控制 |
支持黑名单或白名单世界 |
| 对消息的控制不足 |
每条消息都位于 messages.yml 中,留空即可禁用 |
功能特性
- 可按配置的时间间隔自动清理,并自定义警告时间点列表
- 通过聊天、操作栏、标题和 Boss 栏倒计时发出警告,并伴有音效
- 可清除物品、敌对生物、被动生物、经验球、投射物、落石、激活的 TNT 和空载车辆(各项均可单独选择)
- 智能保护物品和生物,支持 scoreboard 标签 (
chorus_keep) 来保护任意实体
- 物品恢复功能,支持历史记录和过期机制
- 可选的 TPS 触发器:当 TPS 低于设定阈值时启动紧急清理倒计时
- 可选的每区块实体限制器:仅移除超过限制的最早生成的未保护实体
- 按世界检查实体、查找最繁忙的区块、TPS / MSPT / 内存概览、清理统计信息
- 最小在线玩家数设置,避免在空服务器上无意义地扫描
- 完全可定制的消息内容,支持十六进制颜色
颜色支持
所有消息均支持以下格式:
- 十六进制颜色:
&#a855f7、#a855f7 或 <#a855f7>
- 经典颜色和格式代码:
&l、&o、&r 等
默认调色板:#a855f7 #c084fc #d8b4fe #e9d5ff #7c3aed。
命令
别名:/ccl、/chorusclear、/clearlag
| 命令 |
描述 |
权限节点 |
/ccl help |
显示命令列表 |
chorusclearlag.help |
/ccl clear [category] [world] |
立即执行清理(auto, all, mobs, items, hostile, passive, xp, projectiles, falling, tnt, vehicles) |
chorusclearlag.clear |
/ccl check [world] |
统计实体数量及可清理的数量 |
chorusclearlag.check |
/ccl chunks [amount] |
显示拥有最多实体的区块 |
chorusclearlag.chunks |
/ccl tps |
查看 TPS、MSPT、内存、实体和区块信息 |
chorusclearlag.tps |
/ccl next |
距离下次清理的时间 |
chorusclearlag.next |
/ccl stats |
查看清理统计数据 |
chorusclearlag.stats |
/ccl toggle |
启用或禁用自动清理 |
chorusclearlag.toggle |
/ccl mute |
隐藏针对自己的清理公告 |
chorusclearlag.mute |
/ccl restore [list|batch] [radius] |
找回最近清理中被移除的物品 |
chorusclearlag.restore |
/ccl reload |
重载配置文件和消息文件 |
chorusclearlag.reload |
chorusclearlag.admin 授予所有权限。help、next、mute 和 tps 默认对所有玩家开放。
配置
在 plugins/ChorusClearLag/ 目录下生成两个文件:
config.yml:包含间隔时间、警告设置、公告、音效、世界列表、清理对象、保护规则、恢复设置、区块限制器和 TPS 触发器
messages.yml:包含所有消息,支持占位符如 {time}、{total}、{items}、{hostile}、{passive}、{xp}、{projectiles} 和 {protected}
将任何消息设置为 "" 即可禁用它。
若要永久保留某个特定实体,请为其添加 scoreboard 标签:
/tag @e[type=minecraft:armor_stand,limit=1,sort=nearest] add chorus_keep
安装
- 停止服务器
- 将
ChorusClearLag-1.0.0.jar 放入 plugins/ 目录
- 启动服务器并编辑
plugins/ChorusClearLag/config.yml 和 messages.yml
- 使用
/ccl reload 应用更改
兼容性
- Paper 及其分支(Purpur、Pufferfish 等)
- Minecraft 1.21.4 至 26.2
- Java 21 或更高版本(Minecraft 26.1+ 服务器运行于 Java 25)
- 不支持 Folia
常见问题
它会删除我的村民或宠物吗?
不会。村民永远不会被扫描,即使启用了生物清理,驯服、命名、拴绳和骑乘的生物也会受到保护。生物清理功能默认是禁用的。
清理后我能找回物品吗?
可以。使用 /ccl restore list 查看可恢复的清理记录,并使用 /ccl restore 将最新的记录恢复到物品原本的位置。使用 /ccl restore 1 20 仅恢复你周围 20 格内的物品。
手动清理会尊重保护规则吗?
会的。手动清理和自动清理使用完全相同的保护规则。
我可以隐藏公告吗?
玩家可以使用 /ccl mute。管理员可以在 config.yml 中禁用任何类型的公告。
由 Controll3r24 用心制作
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 <#a855f7>
- 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
- Stop your server
- Drop
ChorusClearLag-1.0.0.jar into plugins/
- Start the server and edit
plugins/ChorusClearLag/config.yml and messages.yml
- 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
评论 0
登录后参与评分
还没有评论,来抢沙发吧