WIKI:
MaxClear
MaxClear 是一款轻量级的 Minecraft 服务器清理插件,旨在减少与实体相关的延迟,同时确保重要实体和玩家拥有的物品安全。它支持定时清理、管理员手动清理、按区块的防刷怪限制、可配置的实体过滤器、更新通知、bStats 指标统计以及完全自定义的消息。
功能
- 支持配置间隔时间的定时自动清理。
- 每次自动清理前可选地发送警告广播。
- 供管理员使用的手动清理命令。
- 实体目标列表,精确控制哪些类型的实体可以被移除。
- 实体排除列表,保护重要实体免受清理和区块数量限制检查的影响。
- 对具有自定义显示名称的物品掉落物提供保护。
- 出生点半径保护,确保各世界出生点附近的实体安全。
- 支持世界过滤器,当未列出任何世界时执行全局清理。
- 按区块的实体数量上限,以减少过度的刷怪塔堆积。
- 可配置的前缀、消息及支持使用
&格式的颜色代码。 - 启动时检查更新,启用后每 5 小时检查一次。
- 管理员登录时的更新通知。
- 可选的匿名 bStats 指标统计。
- 运行时重载命令,刷新配置、定时任务、更新检查和指标状态。
- 采用 Bukkit 风格的命令注册,支持
/maxclear和/mc。
请务必查阅 WIKI 以获取有关权限和命令的最新信息
命令
| 命令 | 别名 | 权限 | 发送者 | 描述 |
|---|---|---|---|---|
/maxclear |
/mc |
maxclear.admin (玩家) |
玩家 / 控制台 | 显示命令帮助。 |
/maxclear reload |
/mc reload |
maxclear.admin (玩家) |
玩家 / 控制台 | 重新加载配置并刷新运行时任务、更新检查和指标状态。 |
/maxclear clear |
/mc clear |
maxclear.admin (玩家) |
玩家 / 控制台 | 立即执行一次手动实体清理。 |
/maxclear get author |
/mc get author |
maxclear.admin (玩家) |
玩家 / 控制台 | 显示插件作者。 |
/maxclear get version |
/mc get version |
maxclear.admin (玩家) |
玩家 / 控制台 | 显示当前运行的插件版本。 |
没有 maxclear.admin 权限的玩家无法使用该命令或接收 Tab 补全。控制台可以执行已注册的子命令。
权限
| 权限 | 默认值 | 描述 |
|---|---|---|
maxclear.admin |
op |
允许玩家使用 MaxClear 命令、接收命令 Tab 补全,并在有新版本可用时接收更新通知。 |
清理工作原理
MaxClear 仅移除通过所有配置检查的实体:
- 实体必须位于
entities.types列表中。 - 实体不得位于
entities.exclude列表中。 - 如果启用了
entities.settings.ignore-named-items,则具有自定义显示名称的物品掉落物受到保护。 - 如果
entities.settings.min-distance-from-spawn大于0,则距离世界出生点在该半径内的实体受到保护。 - 如果
entities.settings.worlds不为空,则仅处理列出的世界。
自动清理使用完成消息列表。手动清理使用手动清理消息,并包含命令发送者的名称。
防刷怪区块限制
当启用 chunk-limit.enabled 时,MaxClear 会监听生物生成事件,并限制目标区块内非玩家且未被排除的实体数量。
chunk-limit.max控制每个区块允许的最大实体数量。- 位于
entities.exclude中的实体不计入区块限制计数。 - 玩家实体始终不计入区块限制计数。
- 自定义生成原因不受限制器影响。
此系统有助于减少极端的实体堆积,而不会阻止村民、盔甲架、矿车、船只或其他受保护类型等被排除的实体。
配置
默认配置存储在 config.yml 中。
常规设置
| 路径 | 类型 | 默认值 | 描述 |
|---|---|---|---|
general.prefix |
String | 在 config.yml 中配置 |
插件消息前使用的前缀。 |
general.update-check |
Boolean | true |
启用启动时和定时的更新检查。 |
general.bstats |
Boolean | true |
启用匿名的 bStats 指标统计。 |
自动清理
| 路径 | 类型 | 默认值 | 描述 |
|---|---|---|---|
auto-clear.enabled |
Boolean | true |
启用定时自动清理。 |
auto-clear.interval |
Integer | 300 |
自动清理运行之间的秒数。 |
警告消息
| 路径 | 类型 | 默认值 | 描述 |
|---|---|---|---|
messages.warning.enabled |
Boolean | true |
启用自动清理前的警告广播。 |
messages.warning.seconds-before |
Integer | 10 |
清理前发送警告的秒数。必须低于 auto-clear.interval。 |
messages.warning.message |
String | 可配置 | 警告消息。支持 {time} 占位符。 |
清理消息
| 路径 | 类型 | 描述 |
|---|---|---|
messages.completed.message |
String list | 自动清理后广播的消息。支持 {count}。 |
messages.manual-clear.message |
String | 手动清理后广播的消息。支持 {player} 和 {count}。 |
messages.no-permission |
String | 发送给没有权限的玩家。 |
messages.plugin-reload |
String | 成功重载后发送的消息。 |
messages.subcommand-invalid |
String | 使用了无效的子命令参数时发送的消息。 |
messages.subcommand-specified |
String | 缺少必需的子命令参数时发送的消息。 |
更新消息
| 路径 | 类型 | 描述 |
|---|---|---|
messages.update-available |
String | 管理员加入通知行。支持 {version} 用于显示最新版本。 |
messages.update-current |
String | 管理员加入通知行。支持 {version} 用于显示当前版本。 |
messages.update-download |
String | 在下载 URL 之前显示的管理员加入通知行。 |
更新通知链接至:
https://modrinth.com/plugin/maxclear
实体移除
| 路径 | 类型 | 默认行为 |
|---|---|---|
entities.types |
String list | MaxClear 允许移除的实体类型。 |
entities.exclude |
String list | 受到保护免受清理、且不计入区块限制统计的实体类型。 |
entities.settings.ignore-named-items |
Boolean | 保护带有自定义显示名称的物品。 |
entities.settings.min-distance-from-spawn |
Integer | 保护距离每个世界出生点一定半径内的实体。设为 0 则禁用半径检查。 |
entities.settings.worlds |
String list | 限制清理范围仅在列出的世界中。空列表表示所有世界。 |
默认可移除的实体类型:
entities:
types:
- ITEM
- ARROW
- EXPERIENCE_ORB
- TNT
- FIREWORK_ROCKET
- TRIDENT
- SNOWBALL
- EGG
- ENDER_PEARL
默认受保护的实体类型包括玩家、村民、物品展示框、盔甲架、画作、矿车、船、带箱子的船以及矿车的各种变体。
实体名称别名
MaxClear 支持别名,以兼容新旧版本的实体名称:
| 别名 | 解析为 |
|---|---|
BOAT |
所有常规船只变体,包括橡木、云杉木、白桦木、丛林木、金合欢木、深色橡木、红树林、樱桃木和苍白橡木船。 |
CHEST_BOAT |
所有带箱子的船变体,包括橡木、云杉木、白桦木、丛林木、金合欢木、深色橡木、红树林、樱桃木和苍白橡木带箱子的船。 |
MINECART_CHEST |
CHEST_MINECART |
MINECART_FURNACE |
FURNACE_MINECART |
MINECART_HOPPER |
HOPPER_MINECART |
MINECART_TNT |
TNT_MINECART |
MINECART_MOB_SPAWNER |
SPAWNER_MINECART |
MINECART_COMMAND |
COMMAND_BLOCK_MINECART |
从配置加载时,实体名称会被规范化为大写。
占位符
| 占位符 | 使用位置 | 描述 |
|---|---|---|
{time} |
messages.warning.message |
自动清理前剩余的秒数。 |
{count} |
messages.completed.message, messages.manual-clear.message |
被移除的实体数量。 |
{player} |
messages.manual-clear.message |
手动清理的操作者名称。 |
{version} |
更新消息 | 最新或当前插件版本,具体取决于消息内容。 |
服务器所有者须知
- 如果您的服务器使用了显示实体、NPC、自定义生物或插件管理的实体,请保守设置
entities.exclude。 - 如果您只想在特定世界中进行清理,请使用
entities.settings.worlds。 - 如果您的出生点区域包含装饰性掉落物或受保护的实体,请将
entities.settings.min-distance-from-spawn设置为大于0的值。 - 请确保
messages.warning.seconds-before的值低于auto-clear.interval;无效的警告计时将被安全地禁用并记录日志。 - 对于正常的配置更改,执行
/maxclear reload即可生效。
WIKI:
MaxClear
MaxClear is a lightweight Minecraft server cleanup plugin focused on reducing entity-related lag while keeping important entities and player-owned items safe. It supports scheduled clears, manual admin clears, per-chunk anti-farm limits, configurable entity filters, update notifications, bStats metrics, and fully customizable messages.
Features
- Scheduled automatic cleanup with configurable interval.
- Optional warning broadcast before each automatic clear.
- Manual cleanup command for administrators.
- Entity target list that controls exactly which entity types can be removed.
- Entity exclusion list that protects important entities from cleanup and chunk-limit checks.
- Protection for dropped items with custom display names.
- Spawn-radius protection to keep entities near each world's spawn safe.
- World filter support, with global cleanup when no worlds are listed.
- Per-chunk entity limit to reduce excessive mob farm buildup.
- Configurable prefix, messages, and color-code support using
&formatting. - Update checks on startup and every 5 hours when enabled.
- Join-time update notifications for administrators.
- Optional anonymous bStats metrics.
- Runtime reload command that refreshes config, scheduled tasks, update checks, and metrics state.
- Bukkit-style command registration with
/maxclearand/mc.
Requirements
- Java 21 or newer.
- A modern Minecraft server compatible with Bukkit/Paper APIs.
- Plugin metadata targets
api-version: 1.21.
Paper is recommended for modern production servers. Spigot-compatible servers should only be used if they provide the APIs required by your server version.
REMEMBER TO CHECK THE WIKI TO STAY UP-TO-DATE ON PERMISSIONS AND COMMANDS
Commands
| Command | Alias | Permission | Sender | Description |
|---|---|---|---|---|
/maxclear |
/mc |
maxclear.admin for players |
Player / Console | Shows the command help. |
/maxclear reload |
/mc reload |
maxclear.admin for players |
Player / Console | Reloads the configuration and refreshes runtime tasks, update checks, and metrics state. |
/maxclear clear |
/mc clear |
maxclear.admin for players |
Player / Console | Runs a manual entity cleanup immediately. |
/maxclear get author |
/mc get author |
maxclear.admin for players |
Player / Console | Shows the plugin author. |
/maxclear get version |
/mc get version |
maxclear.admin for players |
Player / Console | Shows the running plugin version. |
Players without maxclear.admin cannot use the command or receive tab completions. Console execution is allowed for the registered subcommands.
Permissions
| Permission | Default | Description |
|---|---|---|
maxclear.admin |
op |
Allows players to use MaxClear commands, receive command tab completions, and receive update notifications when a new version is available. |
How Cleanup Works
MaxClear only removes entities that pass all configured checks:
- The entity must be in
entities.types. - The entity must not be in
entities.exclude. - If
entities.settings.ignore-named-itemsis enabled, dropped items with a custom display name are protected. - If
entities.settings.min-distance-from-spawnis greater than0, entities inside that radius from the world's spawn are protected. - If
entities.settings.worldsis not empty, only listed worlds are processed.
Automatic clears use the completed message list. Manual clears use the manual-clear message and include the command sender name.
Anti-Farm Chunk Limit
When chunk-limit.enabled is enabled, MaxClear listens for creature spawns and limits the number of non-player, non-excluded entities in the target chunk.
chunk-limit.maxcontrols the maximum allowed entity count per chunk.- Entities in
entities.excludeare ignored by the chunk-limit count. - Player entities are always ignored by the chunk-limit count.
- Custom spawn reasons are ignored by the limiter.
This system helps reduce extreme entity buildup without blocking excluded entities such as villagers, armor stands, minecarts, boats, or other protected types.
Configuration
The default configuration is stored in config.yml.
General
| Path | Type | Default | Description |
|---|---|---|---|
general.prefix |
String | Configured in config.yml |
Prefix used before plugin messages. |
general.update-check |
Boolean | true |
Enables startup and scheduled update checks. |
general.bstats |
Boolean | true |
Enables anonymous bStats metrics. |
Automatic Clear
| Path | Type | Default | Description |
|---|---|---|---|
auto-clear.enabled |
Boolean | true |
Enables scheduled automatic cleanup. |
auto-clear.interval |
Integer | 300 |
Seconds between automatic cleanup runs. |
Warning Messages
| Path | Type | Default | Description |
|---|---|---|---|
messages.warning.enabled |
Boolean | true |
Enables a warning broadcast before automatic cleanup. |
messages.warning.seconds-before |
Integer | 10 |
Seconds before the clear when the warning is sent. Must be lower than auto-clear.interval. |
messages.warning.message |
String | Configurable | Warning message. Supports {time}. |
Cleanup Messages
| Path | Type | Description |
|---|---|---|
messages.completed.message |
String list | Broadcast after an automatic clear. Supports {count}. |
messages.manual-clear.message |
String | Broadcast after a manual clear. Supports {player} and {count}. |
messages.no-permission |
String | Sent to players without permission. |
messages.plugin-reload |
String | Sent after a successful reload. |
messages.subcommand-invalid |
String | Sent when an invalid subcommand argument is used. |
messages.subcommand-specified |
String | Sent when a required subcommand argument is missing. |
Update Messages
| Path | Type | Description |
|---|---|---|
messages.update-available |
String | Admin join notification line. Supports {version} for the latest version. |
messages.update-current |
String | Admin join notification line. Supports {version} for the current version. |
messages.update-download |
String | Admin join notification line shown before the download URL. |
Update notifications link to:
https://modrinth.com/plugin/maxclear
Entity Removal
| Path | Type | Default Behavior |
|---|---|---|
entities.types |
String list | Entity types that MaxClear is allowed to remove. |
entities.exclude |
String list | Entity types that are protected from cleanup and ignored by chunk-limit counting. |
entities.settings.ignore-named-items |
Boolean | Protects dropped items with a custom display name. |
entities.settings.min-distance-from-spawn |
Integer | Protects entities inside this radius from each world's spawn. 0 disables the radius check. |
entities.settings.worlds |
String list | Limits cleanup to listed worlds. Empty list means all worlds. |
Default removable entity types:
entities:
types:
- ITEM
- ARROW
- EXPERIENCE_ORB
- TNT
- FIREWORK_ROCKET
- TRIDENT
- SNOWBALL
- EGG
- ENDER_PEARL
Default protected entity types include players, villagers, item frames, armor stands, paintings, minecarts, boats, chest boats, and minecart variants.
Entity Name Aliases
MaxClear supports aliases for compatibility with newer and older entity names:
| Alias | Resolves To |
|---|---|
BOAT |
All regular boat variants, including oak, spruce, birch, jungle, acacia, dark oak, mangrove, cherry, and pale oak boats. |
CHEST_BOAT |
All chest boat variants, including oak, spruce, birch, jungle, acacia, dark oak, mangrove, cherry, and pale oak chest boats. |
MINECART_CHEST |
CHEST_MINECART |
MINECART_FURNACE |
FURNACE_MINECART |
MINECART_HOPPER |
HOPPER_MINECART |
MINECART_TNT |
TNT_MINECART |
MINECART_MOB_SPAWNER |
SPAWNER_MINECART |
MINECART_COMMAND |
COMMAND_BLOCK_MINECART |
Entity names are normalized to uppercase when loaded from the configuration.
Placeholders
| Placeholder | Used In | Description |
|---|---|---|
{time} |
messages.warning.message |
Seconds remaining before the automatic clear. |
{count} |
messages.completed.message, messages.manual-clear.message |
Number of entities removed. |
{player} |
messages.manual-clear.message |
Sender name for a manual clear. |
{version} |
Update messages | Latest or current plugin version, depending on the message. |
Notes for Server Owners
- Keep
entities.excludeconservative if your server uses display entities, NPCs, custom mobs, or plugin-managed entities. - Use
entities.settings.worldswhen you only want cleanup in specific worlds. - Set
entities.settings.min-distance-from-spawnabove0if your spawn area contains decorative dropped items or protected entities. - Keep
messages.warning.seconds-beforelower thanauto-clear.interval; invalid warning timing is disabled safely and logged. - Reloading with
/maxclear reloadis enough for normal configuration changes.
下载 MaxClear
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MaxClear
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MaxClear
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MaxClear
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MaxClear
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MaxClear
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MaxClear
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MaxClear
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MaxClear
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
下载 MaxClear
需要联机服务器吗?
稳定流畅、一键部署,几分钟即可和朋友联机开服
最低仅需 8 元/月 即可畅快联机
- 插件更新消息已更改;现在更简短了。
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
插件
PacketEvents 是一款专为 Minecraft Java 版打造的协议库,旨在简化数据包的处理与传输。
插件
ExyliaPlugins 的库。
插件
通过对话框或铁砧界面帮助你的 Anthme
插件
重新定义服务器上的生物运输方式。使用高度可定制的口袋道具,安全地捕获、存储和释放任何实体。
插件
为基于 Spigot/Paper/Folia 的服务器添加对 Vivecraft 的支持
插件
用于绘制游戏内地图或在浏览器中随探索实时进行地图绘制的实时地图。

评论 0
登录后参与评分
还没有评论,来抢沙发吧