Zzclear

Zzclear

此模组提供实体清理功能

管理

Zzclear 是一款轻量且高度智能的 Minecraft Fabric 实体清理与服务器优化模组。 它在后台静默运行,根据高度可配置的频率计时器,自动清理掉落物品、废弃实体以及导致卡顿的对象。借助强大的游戏内命令系统和可热重载的配置逻辑,它从根源上消除服务器卡顿!


✨ 核心特性

  • 🕐 自动定时清理: 自定义清理周期(可精确到分钟);当计时器触发时,残留实体将被完美清除。
  • 🛡️ 智能白名单与过滤器: 告别“一刀切”式清理!无论是掉落物品、特定怪物还是单个实体类型,Zzclear 都支持通过其黑名单/白名单数组精确绕过和显式指定目标。
  • 🐴 骑乘保护: 当前被玩家骑乘的实体(马、船、矿车等)会自动受到保护,不会被清理。
  • ⏱️ 物品掉落免疫: 可为新掉落的物品设置宽限期,防止其被立即清理。
  • 🌍 维度过滤: 可将特定维度(例如末地)完全排除在清理周期之外。
  • 📊 清理阈值: 当目标实体数量低于可配置的最小值时,跳过清理周期,避免不必要的空跑。
  • 🌐 双语配置: 配置文件注释支持中文和英文,由 language 字段控制。执行 /zzclear reload 后生效。
  • 🪓 全面的实体管理:
    • 标准清理: 掉落物品、经验球
    • 生物清理: 敌对/中立怪物、被动动物
    • 载具/装饰: 船、画、物品展示框
    • 物理/投掷物: 射出的箭、投出的三叉戟、下落的方块、点燃的 TNT、潜影贝子弹、烟花火箭等。
  • 🔄 热重载命令: 修改了配置数据文件?无需重启服务器!一条内置命令即可立即应用新规则。

⌨️ 游戏内命令

主根命令为 /zzclear:

1. 配置重载(管理员)

/zzclear reload

  • 功能: 从磁盘重新读取 config/config.json 文件,并立即应用所有新的清理过滤器、计时周期,同时刷新配置注释语言。

2. 查看清理倒计时(所有玩家)

/zzclear status

  • 功能: 显示距离下一次自动清理的剩余时间(分钟和秒)。

3. 手动立即清理(管理员)

如果你不想等待后台计时器周期,可使用以下命令立即清除特定实体类别:

  • /zzclear items — 立即清除地面上所有掉落物品。
  • /zzclear monsters — 立即清除所有敌对和中立怪物。
  • /zzclear animals — 立即清除所有友好、被动的动物。
  • /zzclear xps — 立即清除所有漂浮的经验球。
  • /zzclear others — 立即清除杂项实体(例如画、船、下落方块、投掷物)。

4. 物品白名单(管理员)

将物品持在主手,即可立即将其注册到白名单过滤器中,防止清理器将其清除:

  • /zzclear white item add — 将当前手持物品添加到全局白名单。
  • /zzclear white item del — 将当前手持物品从全局白名单中移除。

5. 实体 ID 白名单(管理员)

如果你需要精细地保护或排除特定生物或对象(例如 minecraft:zombie),可使用以下端点:

  • /zzclear white entity add <Entity ID> — 将特定实体注册 ID 添加到白名单。
  • /zzclear white entity del <Entity ID> — 将特定实体注册 ID 从白名单中取消注册。

    注意:这些命令完全支持游戏内 Tab 自动补全建议!


🔑 权限节点

未安装 LuckPerms 时,管理员命令需要 OP 等级 4。安装 LuckPerms 后,可使用以下权限节点进行精细控制:

权限 描述 默认
zzclear.command.admin 重载、白名单管理 仅 OP
zzclear.command.items 手动清理物品 仅 OP
zzclear.command.monsters 手动清理怪物 仅 OP
zzclear.command.animals 手动清理动物 仅 OP
zzclear.command.xps 手动清理经验球 仅 OP
zzclear.command.others 手动清理其他实体 仅 OP
zzclear.command.status 查看清理倒计时 所有玩家

⚙️ 配置设置

启动游戏一次后,模组会自动在以下位置生成配置文件:

<game root>/Zzclear/config/config.json

配置文件包含中文或英文注释(由 language 字段控制)。

通用设置

参数 默认值 描述
language "zh" 配置注释语言,zh=中文,en=英文。重载后生效
sweepIntervalMinutes 4 清理间隔(分钟)
warningTimeSeconds 20 清理前警告时间(秒)
finalCountdownSeconds 5 最终倒计时时长(秒)
countdownMessage 中文文本 倒计时警告消息模板,支持 {0} 占位符
sweepCompleteMessage 中文文本 清理完成摘要模板,支持 {0}~{3} 占位符
statusMessage 中文文本 /zzclear status 消息模板
ignoreNamedEntities true 忽略具有自定义名称的实体
ignoreRiddenEntities true 保护被玩家骑乘的实体
newItemImmunitySeconds 0 物品掉落免疫(掉落后的秒数),0=禁用
minEntityCountToSweep 0 触发清理的最小实体数量,0=无限制
dimensionBlacklist [] 排除在清理之外的维度,例如 ["minecraft:the_end"]

物品设置

参数 默认值 描述
sweepItems true 启用物品实体清理
useItemWhitelist false 白名单模式(保护列表中的物品)
useItemBlacklist false 黑名单模式(仅清理列表中的物品)
itemWhitelist [] 物品白名单
itemBlacklist ["minecraft:diamond"] 物品黑名单

生物设置

参数 默认值 描述
sweepLivingEntities true 启用生物实体清理
dropExp false 杀死生物时掉落经验
sweepPassiveAnimals false 清理被动动物
sweepHostileMonsters true 清理敌对怪物
useMobWhitelist true 启用生物白名单模式
useMobBlacklist false 启用生物黑名单模式
mobWhitelist 村民、铁傀儡等 生物白名单
mobBlacklist 村民、铁傀儡 生物黑名单

其他实体设置

参数 默认值 描述
sweepExperienceOrbs false 清理经验球
sweepFallingBlocks false 清理下落方块(例如沙子)
sweepArrows false 清理箭
sweepTridents false 清理三叉戟
sweepProjectiles false 清理投掷物
sweepShulkerBullets false 清理潜影贝子弹
sweepFireworks false 清理烟花火箭
sweepItemFrames false 清理物品展示框
sweepPaintings false 清理画
sweepBoats false 清理船
sweepPrimedTNT false 清理点燃的 TNT

提示: 调整完 JSON 配置后,直接返回游戏并执行 /zzclear reload。即刻完成,零延迟!