MaxClear

插件

· 作者 ZkAleeJoo

优化您的服务器,享受持续改进带来的卓越性能

0 本站下载 0 关注 更新于 2 个月前

最新 4.1.1 · 26.2 · Folia / Paper

一键开服(送7天)

banner

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 仅移除通过所有配置检查的实体:

  1. 实体必须位于 entities.types 列表中。
  2. 实体不得位于 entities.exclude 列表中。
  3. 如果启用了 entities.settings.ignore-named-items,则具有自定义显示名称的物品掉落物受到保护。
  4. 如果 entities.settings.min-distance-from-spawn 大于 0,则距离世界出生点在该半径内的实体受到保护。
  5. 如果 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 即可生效。

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源