# FreeCoreCleaner

**Repository Path**: freecore-mc/FreeCoreCleaner

## Basic Information

- **Project Name**: FreeCoreCleaner
- **Description**: FreeCore 回收站
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-10-30
- **Last Updated**: 2026-10-30

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# FreeCoreCleaner

FreeCore 高性能全自动扫地机、**个人专属多轮垃圾回收站**与**全服公共垃圾场**插件。由小可（CoreNyan）开发维护。

## 功能特性
1. **自动周期清理与倒计时广播**：
   - 支持自定义清理间隔时间（默认 300 秒）。
   - 支持阶段性广播预警（如 60s, 30s, 10s, 5s... 倒计时提示玩家捡起贵重物品）。
2. **玩家独立回收站与归属权严格隔离**：
   - 玩家与玩家之间的回收列表完全独立，互不可见、不可冒领他人财物。
   - 玩家只能看到并取回满足以下条件之一的被清理掉落物：
     - **先前存在过自己背包**：玩家主动丢弃（`PlayerDropItemEvent`）、死亡散落（`PlayerDeathEvent`）、关闭合成台/容器界面滑落等。
     - **自己采集的掉落物**：挖掘方块（`BlockDropItemEvent` / `BlockBreakEvent`）、采摘作物/浆果（`PlayerHarvestBlockEvent`）、剪羊毛（`PlayerShearEntityEvent`）、钓鱼（`PlayerFishEvent`）、击杀生物（`EntityDeathEvent`）等。
   - 自然刷怪塔、红石机器全自动产出的无主垃圾会被正常清走，不会混入其他玩家的回收站。
3. **全服公共垃圾场（无限页数 & 自由存取）**：
   - 玩家可通过 `/trash public` 指令或从 `/trash` 主菜单底部的炼药锅按钮进入全服公共垃圾场。
   - **页数无限增长**：随着玩家放入的物品数量增加，页数自动无限扩展，支持上一页/下一页无缝翻页。
   - **自由放入与捡取**：打开公共垃圾场时，直接点击自己背包里的物品即可放入公共垃圾场；左键点击垃圾场内的物品即可捡取到自己背包。
   - **定时自动清空与持久化**：默认每隔 `7d`（7天）自动清空一次，支持在 `config.yml` 的 `public-trash.clear-interval` 中配置（支持 `7d`、`24h`、`30m` 等格式），且数据自动持久化到 `public-trash.yml`。
4. **多轮回收站与历史回溯**：
   - 保留前 $x$ 轮（默认 10 轮，完全可配）的历史记录。
   - 主菜单支持浏览每轮清理的历史信息（时间、属于你的被回收件数、你的剩余待取回数）。
5. **物品零损耗兼容与取回/销毁**：
   - 完美保留掉落物的所有 NBT、PDC、组件属性（100% 兼容 FreeCoreItem 及各类自定义物品）。
6. **完善的多语言 (Lang) 与消息系统**：
   - 输出风格统一对齐 FreeCoreShop / FreeCoreItem。
   - 默认搭载 `zh_CN.yml`，支持 MiniMessage 渐变与标准 `&` 颜色代码。
7. **重载与管理指令**：
   - `/trash` - 玩家打开个人专属回收站主菜单（别名：`/fctrash`, `/recycle`, `/fcbin`）。
   - `/trash public` - 玩家直接打开全服公共垃圾场（或 `/cleaner public`）。
   - `/fccleaner help` - 查看帮助手册。
   - `/fccleaner clean` - OP 立即强制触发清理。
   - `/fccleaner reload` - OP 热重载配置与语言文件。

## 权限节点
- `freecorecleaner.trash`：打开个人回收站与公共垃圾场权限（默认所有玩家拥有）。
- `freecorecleaner.clean`：手动触发清理权限（默认 OP）。
- `freecorecleaner.reload`：重载插件权限（默认 OP）。
- `freecorecleaner.admin`：管理权限（拥有所有管理权限及一键清空按钮）。