
ClearLagg 会自动移除导致延迟的实体,同时确保玩家、受保护的生物以及由插件管理的实体安全。所有设置均可配置,并可在游戏内重新加载。
- ⏱️ 自动清理 — 启用或禁用该功能,并设置间隔时间
- ? 自定义警告 — 在每次清理前发出警告
- ? 实体分类 — 物品、投射物、经验球、船、矿车、物品展示框、画、点燃的 TNT 以及生物
- ?️ 玩家保护 — 玩家永远不会被移除
- ? 按类型和自定义名称的规则 — 针对特定生物类型的规则
- ? MythicMobs 支持 — 通过内部 ID 保护自定义生物
- ? 区域清理 — 围绕玩家半径内的区域进行清理
- ? 当前世界或所有世界清理
- ? ItemsAdder 保护 — 清理时受到保护,可选择将其包含在区域清理中
- ? 第三方实体保护 — 通过插件命名空间实现
- ? 热重载 — 无需重启服务器即可重载
config.yml 和 lang.yml
- ? 自定义消息 — 支持十六进制颜色、渐变色和加粗文本

主命令:/clearlagg(别名:/lagg)
| 命令 |
描述 |
权限 |
/clearlagg / /clearlagg help |
显示帮助菜单 |
clearlag.command |
/clearlagg time |
检查距离下次自动清理的剩余时间 |
clearlag.time |
/clearlagg clear |
清理当前世界中配置的实体 |
clearlag.clear |
/clearlagg clearall |
清理所有世界中配置的实体 |
clearlag.clearall |
/clearlagg area <radius> [-ia] |
清理你周围的实体;-ia 包含 ItemsAdder 实体 |
clearlag.area |
/clearlagg reload |
重载配置、消息和集成 |
clearlag.reload |
clear 和 area 仅限玩家使用。clearall、time 和 reload 也可以从控制台运行。

| 权限 |
描述 |
默认值 |
clearlag.* |
访问所有 ClearLagg 命令 |
op |
clearlag.command |
访问主命令 |
true |
clearlag.admin |
接收更新通知 |
op |
clearlag.time |
检查距离下次清理的时间 |
true |
clearlag.clear |
清理当前世界 |
op |
clearlag.clearall |
清理所有世界 |
op |
clearlag.area |
清理半径内的实体 |
op |
clearlag.reload |
重载插件 |
op |
访问 /clearlagg 还需要 clearlag.command 权限;每个子命令也会检查其各自的权限。

config.yml 和 lang.yml 文件会在插件的数据文件夹中创建。
自动清理
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
每条警告必须低于清理间隔。无效条目将被跳过并在控制台中报告。
生物排除
这些保护仅适用于生物,默认情况下除命名生物外均启用:
auto-removal:
mob-exclusions:
armor-stands: true
villagers: true
tamed-animals: true
leashed: true
mounted: true
named: false
生物规则
mob-rules 使用显式操作。protect 规则防止移除,而 remove 规则即使在 mob 类别禁用的情况下也会针对某种生物类型。
mob-rules:
- type: "LLAMA"
action: "protect"
custom-name-contains: "PINATA"
- type: "ZOMBIE"
action: "remove"
可用过滤器:
custom-name — 精确名称,或使用 "*" 匹配任何自定义名称
custom-name-contains — 匹配包含给定文本的任何名称
为了兼容性,旧的 protected-mobs 格式仍会被读取:单独的类型会移除生物,而带有名称的类型则会保护它。
第三方实体保护
某些插件使用自定义命名空间标记它们的实体。在下面添加这些命名空间,这样 ClearLagg 就不会移除它们:
protected-namespaces:
- "example-plugin"
- "mycustomplugin"
上面的值是示例:请使用拥有你想保留的实体的插件的命名空间。任何携带已列出命名空间数据的实体都将被跳过,无论启用了哪些类别。
区域清理
area:
max-radius: 500
/clearlagg area <radius> 的最大值受此值限制,且半径必须是有效的正数。
更新检查器
update-checker:
enabled: true
project-id: "clearlagg"
notify-console: true
notify-on-join: true
project-id 是 Modrinth 项目标识符。加入通知仅发送给拥有 clearlag.admin 权限的玩家。
消息
在 lang.yml 中自定义游戏内的每条消息。支持十六进制颜色 (&#RRGGBB)、渐变 (<gradient:#FF0000:#FF3333>text</gradient>) 和加粗标签 (<bold>text</bold>)。
使用 /clearlagg reload 应用更改而无需重启服务器。

- ItemsAdder — 其实体默认受到清理保护。使用
/clearlagg area <radius> -ia 将其包含在区域清理中。
- MythicMobs — 通过将其内部 ID 添加到
mythicmobs.protected-mobs 来保护自定义生物:
mythicmobs:
protected-mobs:
- "ExampleBoss"
兼容性
- Paper 或 Spigot 1.21+
- Java 17+
- 所有集成均为可选;插件无需它们即可正常运行。

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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧