Bukkit ItemRecycle - 掉落物回收插件 1.0.0

ItemRecycle 插件文档​

插件概述​

主要功能​

• 自动回收: 自动收集世界中的掉落物
• 图形界面: 直观的 GUI 界面查看和管理物品
• 深度集成: 与 LGEntityClear 插件无缝协作
• 命令控制: 完整的命令系统和权限管理

命令列表​

权限节点​

• ItemRecycle.command - 使用 ItemRecycle 所有命令的权限（默认：所有玩家）

配置说明​

重要提示: 要使插件正常工作，需要在 plugins\LGEntityClear\clear_task.yml 文件中添加以下配置模板：

点击展开...

item_recycle:
  # 是否启用
  enable: true
  # 清理间隔[单位: 秒]
  interval: 9007
  message:
    60: "[§c掉落物回收§f] 距离回收还有 60 秒"
    30: "[§c掉落物回收§f] 距离回收还有 30 秒"
    10: "[§c掉落物回收§f] 距离回收还有 10 秒"
    5: "[§c掉落物回收§f] 距离回收还有 5 秒"
    4: "[§c掉落物回收§f] 距离回收还有 4 秒"
    3: "[§c掉落物回收§f] 距离回收还有 3 秒"
    2: "[§c掉落物回收§f] 距离回收还有 2 秒"
    1: "[§c掉落物回收§f] 距离回收还有 1 秒"
    clear: "[§c掉落物回收§f] 已回收 {count} 个实体，耗时 {executionTime} 毫秒"
  # 实体删除方式
  remover:
    name: item_recycle
  # 世界过滤器
  world_filter:
    # 过滤方法 [white, black]{白名单 黑名单}
    name: white
    attribute:
      list:
        - world
  # 实体过滤器
  entity_filter:
    name: item_recycle
    attribute:
      list:

使用方法​

1. 打开界面: 玩家输入 /ir open 命令打开物品回收界面
2. 浏览物品: 在界面中查看所有被回收的物品
3. 取回物品: 点击相应物品槽位即可取回物品
4. 溢出处理: 若背包已满，多余物品会重新掉落在玩家脚下

界面操作指南​

• 物品展示区: 前 45 个槽位显示可回收的物品
• 翻页控制:
  • 左下角绿色玻璃板：上一页
  • 右下角绿色玻璃板：下一页
• 装饰区域: 底部中央玻璃板仅为界面美观

技术架构​

核心组件​

• ItemRecycle - 主插件类，负责初始化和注册组件
• DropItemManager - 物品管理器，存储和管理所有被回收的物品
• MainGUI - 图形界面类，提供物品查看和取回功能
• ComponentUtil - 组件工具类，创建实体过滤器和移除器

命令系统​

• AbstractMainCommand - 抽象主命令类
• MainCommand - 主命令实现
• SubCommand - 抽象子命令类
• OpenCommand - 打开界面子命令
• HelpCommand - 帮助子命令

依赖插件​

• LGLibrary - 基础库支持
• LGEntityClear - 实体清理核心插件

注意事项​

1. 确保 plugins\LGEntityClear\clear_task.yml 文件中正确配置了任务模板
2. 插件依赖于 LGLibrary 和 LGEntityClear 插件，必须先安装这些依赖
3. 配置文件中的清理间隔（默认9007秒）可根据服务器实际需求进行调整
4. 建议在生产环境使用前进行充分测试