
ClearItems
A high-performance item cleanup mod for Fabric. > 专为 Fabric 打造的高性能掉落物清理模组。
查看大图🧹 ClearItems - 自动化实体清理
ClearItems 是一款专为 Fabric 生态构建的生产级清理模组。它在确保极端环境稳定性的同时,提供了更灵活的权限调用机制,是大型整合包与自动化管理服务器的理想选择。
💎 核心技术优势
🛡️ 全环境兼容性架构(免权限逻辑)
- 权限等级解耦:重构了指令触发逻辑,移除了底层对
isOp()的强制判定。允许通过自动化脚本、非 OP 玩家(需配合权限插件)或命令方块直接调用。 - 极速环境适配:针对重度混淆的服务器环境进行了深度调优,确保在大型模组环境下稳定运行。
🟢 高兼容性渲染架构(ActionBar 优先)
- 零 UI 冲突:采用 ActionBar 文本注入 代替传统的 BossBar,彻底规避屏幕上方 UI 叠加导致的视觉冲突。
- 原生感设计:彩色文字随时间动态切换(绿色 > 黄色 > 红色),视觉反馈直观且轻量。
🚀 核心功能
- 📋 实时查询(白名单查询):使用
/clearitems list随时监控受保护物品状态。 - 🛠️ 极致稳定:针对高负载环境优化的防御性逻辑,清理周期精准不漂移。
- 📈 原子级战报:精准统计掉落物 实际总堆叠数量,而非仅统计实体个数。
- ⚙️ 极简开销:基于原生 Fabric API,与 Lithium、FerriteCore 等优化模组完美兼容。
🎮 指令参考手册
| 指令 | 参数 | 描述 |
|---|---|---|
| set | <seconds> |
设置清理周期 |
| add | <item_id> |
添加白名单 |
| remove | <item_id> |
移除白名单 |
| list | — | [新增] 查看白名单 |
| clear | — | 立即执行清理 |
📦 安装与协议
- Minecraft: 1.21.x
- Requirement: Fabric API
- License: MIT License
⚠️ 安全提示:
由于移除了指令的权限等级要求,若您在公网服务器运行,请务必使用权限管理插件(如 LuckPerms)对
/clearitems指令进行节点控制,以确保服务器安全。
❓ 常见问题解答
Q: 为什么我看不到 BossBar 倒计时了?
- 为了兼容 200+ 模组的重型整合包,自 v1.1.1 起我们将提示切换到了 ActionBar(快捷栏上方),有效规避了 UI 堆叠冲突。
Q: 为什么非 OP 玩家也能使用指令?
- 我们移除了硬性的 OP 权限检查以支持脚本自动化。在公网服务器上,请务必使用 LuckPerms 对权限节点进行控制,防止非法调用。
Q: 会清理掉盔甲架或展示框里的装备吗?
- 不会。 ClearItems 仅针对掉落物实体(Item Entity),不会影响任何已经放置的容器、盔甲架或展示框。
Q: 如何保护特定物品不被清理?
- 使用指令
/clearitems add <item_id>(例如minecraft:diamond)将其加入白名单。白名单内的物品将永远受到保护。
Q: 兼容 Lithium、FerriteCore 等优化模组吗?
- 完美兼容。 模组基于原生 Fabric API 编写,不修改核心逻辑,与各类底层优化模组并行无压力。
👀 即将到来(v1.2.0)
我们正在全速开发全新的 显示切换系统(Flexible HUD Engine)!在即将到来的 v1.2.0 版本中,您将拥有前所未有的自定义体验:
- 🚦 双模式渲染:您将可以在经典的 BossBar(适合轻量整合包)与高性能的 ActionBar(适合 200+ 模组的重型整合包)之间自由切换。
- ⚙️ 配置文件支持:引入
config.json,允许永久指定默认的显示模式,并支持动态加载。 - 即时切换指令:新增管理员指令,可在游戏内即时更改 UI 表现形式,无需重启。
正在加载版本记录…


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