ZzaiClear

模组

· 作者 Zzai

此模组提供实体清理功能

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

最新 2.0.0 · 1.21.8 · Fabric

一键开服(送7天)

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 Villagers, Iron Golems, etc. 生物白名单
mobBlacklist Villagers, Iron Golems 生物黑名单

其他实体设置

参数 默认值 说明
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。立即生效,绝对零延迟!

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

评论 0

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

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源