EzClean

插件

· 作者 Shadow48402

可配置的实体定期清除及其他高级工具,用于防止卡顿

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

最新 3.0.1 · 26.1.2 · Bukkit / Folia

一键开服(送7天)

EzClean - Minecraft 实体清理插件

自动化实体清扫、实时倒计时、付费取消、Discord Webhook、PlaceholderAPI、Spark 分析以及异步调度器监控,适用于 Paper 26.1+、Spigot 和 Purpur。

平台: Paper 26.1+、Spigot/Bukkit、Purpur | Java: 17+ | 存储: SQLite(内置)或 MySQL
可选依赖: Vault、WorldGuard、Discord、PlaceholderAPI、Spark、EzCountdown

查看我们的最新项目:PvPIndex


为什么选择 EzClean?

EzClean 专为对性能、灵活性和安全性有要求的现代 Minecraft 服务器而设计。以下是其亮点:

  • 100% SpigotMC/Bukkit 兼容 – 可在 Spigot、Paper 和 Purpur 上运行。无仅依赖 Paper 的组件。
  • 基于配置文件的调度 – 创建多个清理配置文件,每个配置文件拥有独立的间隔时间、世界目标、实体规则和广播消息。
  • 交互式倒计时 – 使用 MiniMessage 占位符实现主题化警告、回顾和仅限工作人员使用的取消提示:{minutes}、{count}、{cleaner}、{cost}。
  • 细粒度移除规则 – 切换敌对生物、被动生物、村民、载具、掉落物、经验球、投射物、TNT、云。保护玩家、盔甲架、显示实体、驯服宠物和命名生物。
  • 世界定向 – 清理特定世界或使用 * 进行全网络范围的清扫。
  • 强制保留/移除列表 – 标记任何 EntityType 以始终保留或移除,用于自定义事件或机制。

功能亮点

EzClean 提供强大的功能,以保持您的 Minecraft 服务器平稳运行并让玩家满意:

  • MiniMessage 就绪 – 使用 Adventure MiniMessage 标签实现主题化警告、间隔、动态、预清理和取消广播:minutes、count、cleaner id、cancel costs。
  • WorldGuard 集成 – 带有 ezclean-bypass 标志的区域在实体清扫时会自动被跳过。
  • 付费取消安全网 – 可选的 Vault 挂钩允许您向玩家收取取消清理的费用,支持悬停工具提示和退款保护。
  • 安全默认值 – 关键实体受到保护,直到您明确选择将其移除。
  • 轻量级配置 – 清理器、MiniMessage 副本和死亡宝箱均包含在整洁的 YAML 文件中。
  • 热重载友好 – 使用您喜欢的插件管理器或 /reload confirm 即时重新加载配置文件更改。
  • 智能堆叠检测 – 自动削减超过每区块限制的掉落物堆或其他 spammy 实体。
  • 实体合并 – 在移除前合并附近同类型的实体,以减少数据包垃圾并提高清扫效率。
  • 可选死亡宝箱 – 将玩家的掉落物捕获到临时容器中,这些容器会在计时结束后消失,而不是让物品散落一地。
  • 语言 / i18n 支持 – 内置英语、荷兰语和西班牙语翻译;将任何 <lang>.yml 放入 lang/ 文件夹即可添加自己的语言环境。
  • Discord Webhook 通知 – 通过在 config.yml 中设置 Webhook URL,将清理摘要发布到 Discord 频道。无需机器人令牌或额外插件。
  • PlaceholderAPI 支持 – 暴露实时统计信息作为 %ezclean_<stat>% 占位符,用于记分板、全息图和聊天格式化程序。
  • Spark 集成 – 使用 Spark 精确的 TPS/MSPT 滚动平均值进行更智能的调度,并在实体数量激增时触发自动分析会话。
  • EzCountdown 集成 – 通过 EzCountdown 驱动预清理倒计时,以实现更丰富、可主题化的公告。
  • 基于存储的统计 – 使用内置 SQLite 数据库或外部 MySQL/MariaDB 实例跨重启持久保存清理统计数据。
  • 更新通知器 – 当有新版本的 EzClean 可用时,操作员会收到聊天中的可点击通知。
  • 交互式设置 GUI – 通过点按式库存向导配置清理配置文件,无需触碰 YAML。

配置清理内容

完全控制从您的 Minecraft 服务器中移除或保护的实体。混合搭配配置文件、实体组和自定义规则,以获得终极灵活性。

  • 创建无限数量的清理配置文件,每个配置文件拥有独特的世界目标、倒计时节奏和广播消息。
  • 按配置文件切换实体组(敌对生物、被动生物、村民、载具、掉落物、经验球、投射物、 云、下落方块、TNT)。
  • 使用 keep/remove 数组微调特定的 EntityType 值,以保护自定义生物或清除事件杂物。
  • 混合配置文件以实现全局清扫、特定世界的清理或专用竞技场,而不影响其他计划。
  • 重新加载插件以即时应用更改,并通过 /ezclean time 监控更新的倒计时。

付费取消清理

让工作人员只需单击一次即可延迟计划的清理,可选择收取基于 Vault 的费用并显示动态 MiniMessage 提示。

  • 可点击的倒计时广播让拥有 ezclean.cancel 权限的工作人员立即延迟下一次清理。
  • 按配置文件收取可选的基于 Vault 的费用,如果取消失败则自动为玩家退款。
  • 使用 MiniMessage 占位符自定义悬停、成功、广播和错误消息:{player}、{cleaner}、{minutes}、{cost}。
  • 没有权限的玩家看到标准警告,确保该功能仅限于受信任的等级。

监控异步调度器负载

Scheduler Monitor Example

追踪卡顿原因

EzClean 使诊断和追踪服务器卡顿源变得容易,特别是当卡顿与计划任务或插件活动有关时。使用以下功能来定位卡顿原因:

  • 调度器使用快照:

    • 运行 /ezclean usage 以即时查看所有待处理的同步和异步任务的分解情况, 按插件排序。这有助于您识别哪些插件安排了最多的工作并可能导致卡顿。
  • 实时使用监控:

    • 使用 /ezclean usage live 开始在聊天栏和操作栏中显示实时数据流,展示任务计数以及最繁忙的插件及其变化。这非常适合在延迟峰值出现时立即捕捉到它们,并将其与插件活动关联起来。
  • 插件过滤:

    • 在 /ezclean usage 或 /ezclean usage live 后添加插件名称,以专注于特定插件的计划程序活动。
  • 停止数据流:

    • 随时使用 /ezclean usage stop 结束实时监控会话。
  • 视觉反馈:

    • 操作栏图表和聊天输出使得轻松发现计划任务的突然增加变得容易,这些增加通常与延迟事件相关。

提示: 如果你注意到计划任务激增或某个特定插件主导了计划程序,请调查该插件的配置或近期活动。EzClean 的工具在高峰时段或添加新插件后特别有用。

Scheduler Monitor Example


可选死亡宝箱

  • 将玩家掉落物转换为位于死亡地点附近的 54 格箱子,而不是让物品散落在地面上。
  • 设置消失计时器(或使箱子永久存在),如果箱子被破坏或过期,则自动掉落剩余物品。
  • 自定义 MiniMessage 库存标题,并无需重启服务器即可动态切换此功能。
  • 保持地面整洁,避免杂乱的掉落堆,这样你的清理周期一开始就需要处理的物品就少得多。

高级死亡宝箱选项(可选)

  • 每个玩家的宝箱限制 – 限制每个玩家同时拥有的活跃死亡宝箱数量,以防止滥用和杂乱。
    • 示例:

      max-chests-per-player: 2
      

      超过限制的玩家将自动移除其最旧的宝箱。

      • 权限:ezclean.deathchest.limit.bypass 允许玩家忽略宝箱限制。
  • 可配置的战利品保护 – 在死亡后的指定时间(例如 5 分钟)内,只有所有者可以打开他们的死亡宝箱,之后任何人都可以访问。
    • 示例:

      loot-protection:
        enabled: true
        owner-only-minutes: 5
      
      • 权限:ezclean.deathchest.protection.bypass 允许玩家无视保护时间打开任何宝箱。
  • 宝箱上方的全息图或粒子效果 – 在每个死亡宝箱上方显示浮动标签或视觉效果,以便轻松定位。
    • 示例:

      hologram:
        enabled: true
        text: "<gold>Death Chest</gold>"
      particles:
        enabled: true
        type: VILLAGER_HAPPY
      

管理员命令

  • /ezclean help – 列出所有可用的子命令及其所需的权限。
  • /ezclean setup – 打开交互式库存 GUI,无需编辑 YAML 即可配置清理配置文件。
  • /ezclean run [cleaner] – 当工作人员需要手动清理时,立即触发任何已配置的配置文件。
  • /ezclean cancel [cleaner] – 通过命令或可点击的广播提示来延迟下一次清理周期(并可选择收取 Vault 费用)。
  • /ezclean time [cleaner] – 检查距离下次计划清理运行还有多少分钟。
  • /ezclean reload – 重新加载 EzClean 的配置包而无需重启,以应用新的配置文件、消息或实体规则。
  • /ezclean usage [plugin|live|stop] [plugin] – 诊断高计划程序使用情况、启动实时监控或取消活动会话 (ezclean.usage)。
  • /ezclean stats [cleaner] – 查看清理配置文件的详细统计信息,包括运行次数、移除的实体总数、平均持续时间、TPS 影响以及受影响最多的世界/组。
  • ezclean.deathchest.limit.bypass – 允许玩家忽略每个玩家的死亡宝箱限制。
  • ezclean.deathchest.protection.bypass – 允许玩家无视战利品保护计时器打开任何死亡宝箱。

快速开始

  • 将 EzClean.jar 放入 Paper 或 Purpur 服务器的 plugins/ 目录并重启服务器。
  • 在首次启动时,让 EzClean 在其数据文件夹中生成 cleaners/default.yml、messages.yml 和 death-chests.yml。
  • 复制 cleaners/default.yml 以创建针对特定世界的调度配置,然后调整每个配置文件的世界列表、移除开关、广播频率和取消成本。
  • 在 messages.yml 中自定义广播主题,在 death-chests.yml 中调整死亡宝箱计时器,然后重新加载插件(或重启)以应用更改,最后检查 /ezclean time。

WorldGuard 绕过标签

  • 将 WorldGuard 与 EzClean 一起安装以解锁基于区域的排除功能。
  • EzClean 在启动期间会自动注册 ezclean-bypass 状态标志。无需手动设置标志。
  • 使用 /rg flag <region> ezclean-bypass allow 标记安全区(出生点、展示区、红石实验室),这些区域应永远不被清理。
  • 当你希望 EzClean 恢复从该区域移除实体时,将标志切换回 deny(或删除它)。
  • 处于 allow 区域内的实体将被跳过,而服务器的其余部分正常进行清理。

清理范围一览

类别 默认值 说明
敌对生物 启用 移除 Enemy 实例,除非明确保留。
被动生物 禁用 清除 Animals、WaterMob、Ambient、Golem 和 Allay 实体
村民与商人 禁用 针对村民和流浪商人(AbstractVillager)
载具 禁用 移除如船和矿车等 Vehicle 实体
掉落物 启用 全局清除松散的 Item 实体
投射物与经验球 启用 针对箭矢、雪球、投掷药水及经验球
区域效果云 启用 清理战斗频繁区域的滞留药水云
下落方块与 TNT 启用 移除异常下落方块和已点燃的 TNT
玩家、盔甲架与显示实体 受保护 除非关闭 protect.* 开关,否则保持完整
驯服生物 受保护 当 protect.tamed-mobs 启用时将被忽略
命名生物 受保护 当 protect.name-tagged-mobs 开启时,跳过具有自定义名称的实体

示例配置

cleaners/default.yml

interval-minutes: 60

warning:
  enabled: false
  minutes-before: 5

broadcast:
  start:
    enabled: true
  summary:
    enabled: true
  interval:
    enabled: false
    every-minutes: 15
  dynamic:
    enabled: false
    minutes: [30, 15, 10, 5]

cancel:
  enabled: true
  cost: 50000.0

worlds:
  - "*"

pile-detection:
  enabled: true
  max-per-block: 120
  entity-types:
    - ITEM
    - EXPERIENCE_ORB
  ignore-named-entities: true

remove:
  hostile-mobs: true
  passive-mobs: false
  villagers: false
  dropped-items: true
  projectiles: true
  experience-orbs: true
  area-effect-clouds: true
  falling-blocks: true
  primed-tnt: true

protect:
  players: true
  armor-stands: true
  display-entities: true
  tamed-mobs: true
  name-tagged-mobs: true

entity-types:
  keep: []
  remove: []

messages.yml

defaults:
  warning:
    message: "<yellow>⚠ 实体清理将在 <gold>{minutes}</gold> 分钟后开始。请清空贵重物品!</yellow>"
  broadcast:
    start:
      message: "<red><bold>✦ 实体清理已开始...</bold></red>"
    summary:
      message: "<gray>✓ 已移除 <gold>{count}</gold> 个实体。下次清理在 <gold>{minutes}</gold> 分钟后。</gray>"
    pre-clean:
      message: ""
    interval:
      message: "<yellow>⚠ 清理将在 <gold>{minutes}</gold> 分钟后开始。请清空贵重物品!</yellow>"
    dynamic:
      message: "<gold>⏳ {cleaner} 清理将在 <yellow>{minutes}</yellow> 分钟后进行!</gold>"
  stats-summary:
    message: "<gray><aqua>{cleaner}</aqua> 的清理统计:<gold>{runs}</gold> 次运行,共移除 <gold>{total_removed}</gold> 个实体。平均耗时: <gold>{avg_duration}</gold>。平均 TPS 影响: <gold>{avg_tps_impact}</gold>。主要组别:{top_groups}。主要世界:{top_worlds}。</gray>"
  cancel:
    hover-message: "<yellow>点击支付 <gold>{cost}</gold> 以取消此次清理。</yellow>"
    success-message: "<green>您支付了 <gold>{cost}</gold> 以取消 <aqua>{cleaner}</aqua> 的清理任务。</green>"
    broadcast-message: "<gold>{player}</gold> 取消了 <aqua>{cleaner}</aqua> 的清理任务。下次清理在 <yellow>{minutes}</yellow> 分钟后。"
    insufficient-funds-message: "<red>您需要 <gold>{cost}</gold> 才能取消清理任务。</red>"
    disabled-message: "<red>此清理任务无法取消。</red>"
    no-economy-message: "<red>经济系统不可用。无法取消清理任务。</red>"

cleaners: {}

death-chests.yml

enabled: false
despawn-minutes: 30
inventory-title: "<gold>死亡宝箱</gold>"

要求

  • Java 17 或更高版本(匹配 Paper 26.1 API 基线)。
  • Paper 或 Purpur 26.1+ 服务器构建版本。
  • SQLite 已内置。无需额外设置。若需使用 MySQL/MariaDB,请在 config.yml 中设置 storage.type: mysql。
  • Vault + 经济插件(仅在启用付费取消清理功能时需要)。
  • 可选:PlaceholderAPI、Spark、EzCountdown、WorldGuard(启动时自动检测)。
  • 可选:一个插件管理器,如果您更喜欢在游戏内重载而非完全重启。

支持与链接

  • 有问题或功能请求?加入我们的 Discord 并在 EzClean 分类下提交工单。
  • 在您的资源讨论帖中分享性能反馈或建议,以便我们持续优化默认设置。

准备好迎接整洁的世界了吗? 今天安装 EzClean,让自动化清理工具处理繁琐工作,而工作人员则专注于服务玩家!

尝试 EzPlugins 系列中的其他 Minecraft 模组

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源