
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。即刻完成,零延迟!
正在加载版本记录…

正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。