ClearItems

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 表现形式,无需重启。