RecyclingService

Overview

Recycling Service is a server-side cleanup mod that lets players recover cleaned items.
Instead of deleting items permanently, cleaned drops are moved into dimension-based trash boxes.
Players can pay a configurable fee to retrieve them later.

Note: Trash boxes are temporary and are cleared on the next cleanup cycle (and on server restart).

---

Features

Auto Cleanup System
- Configurable cleanup interval (default: 10 minutes)
- Countdown warnings before cleanup
- Whitelist / Blacklist filtering modes
- Projectile cleanup (arrows, fireballs, etc.)
- Minimum age before an entity can be cleaned (default: 10s)
- Create mod integration — protects items being processed

Trash Box System
- Dimension-based trash boxes (up to a configurable max per dimension)
- Auto-cleaned items go to Box 1 by default
- Extended stack size (default: 64 × 100 = 6400 per slot)
- Cross-dimension access support
- Items grouped by type with real-time count display
- Cleanup report includes clickable buttons to open trash boxes

Payment System
- Configurable payment item (default: emerald)
- Payment modes:
  - all_free — no cost
  - current_dimension_free — free in same dimension
  - all_dimensions_pay — always costs
- Custom cost formula with variables:
  base, count, recent, same_dim, cross_dim, multiplier
- Per-dimension multipliers and cost caps
- Frequent extraction penalty

Debug
- /bin debug [on|off] — show cache counts in ActionBar every second (admin)
  When debug is enabled, it takes priority over countdown warnings.

---

Commands

/bin
/bin open <dimension> <box>
/bin cleanup      (admin)
/bin reload       (admin)
/bin debug [on|off] (admin)

---

How It Works

Item dropped → minimum age check → reported to cache
                         ↓
                Cleanup triggered
                         ↓
      Reported items moved to trash box (Box 1)
                         ↓
       Player opens trash box via /bin or button
                         ↓
             Pay postage → Retrieve items

---

FAQ

Q: What happens if I don’t retrieve items?  
A: Trash boxes are temporary and are cleared on the next cleanup cycle (or server restart).

Q: Can I disable the payment system?  
A: Yes, set extract_mode = "all_free".

Q: Does it work with modded items?  
A: Yes, use full item IDs like modname:itemid in whitelist/blacklist.

Q: Is a client mod required?  
A: No, server-side only.

---

Links

GitHub: https://github.com/KlN-4096/recyclingservice

---

License

GPL-3.0 (see LICENSE)
---------------------------------------------------------------------------------------------------------------------

概述

Recycling Service 是一个服务端物品清理模组，带有回收系统。
清理的掉落物不会永久删除，而是先进入维度垃圾箱，玩家可以付费取回（可配置）。

注意：垃圾箱是临时的，会在下一次清理周期（或服务器重启）时被清空。

---

核心功能

自动清理
- 可配置清理间隔（默认 10 分钟）
- 清理前倒计时提示
- 白名单 / 黑名单过滤
- 弹射物清理（箭、火球等）
- 物品最小存活时间（默认 10s）
- Create 兼容（保护加工中的物品）

垃圾箱
- 每个维度有独立垃圾箱（数量可配置）
- 自动清理物品默认进入 1 号箱
- 超大堆叠（默认 64 × 100 = 6400）
- 支持跨维度访问
- 物品按类型分组，实时显示数量
- 清理结果消息带可点击按钮快速打开垃圾箱

邮费系统
- 可配置支付物品（默认绿宝石）
- 支付模式：
  - all_free：全部免费
  - current_dimension_free：同维度免费
  - all_dimensions_pay：全部收费
- 支持自定义公式（base/count/recent/same_dim/cross_dim/multiplier）
- 维度倍率与费用上限
- 频繁取回惩罚

调试
- /bin debug [on|off] — 每秒 ActionBar 显示缓存数量（管理员）
  Debug 开启时优先级高于倒计时提示。

---

命令

/bin
/bin open <维度> <编号>
/bin cleanup      （管理员）
/bin reload       （管理员）
/bin debug [on|off]（管理员）

---

工作流程

物品掉落 → 最小存活时间检查 → 上报缓存
                         ↓
                触发清理
                         ↓
      已上报物品进入垃圾箱（默认 1 号箱）
                         ↓
    玩家通过 /bin 或按钮打开垃圾箱
                         ↓
           支付邮费 → 取回物品

---

FAQ

Q：不取回会怎么样？  
A：垃圾箱是临时的，会在下一次清理周期（或服务器重启）时被清空。

Q：能关闭邮费吗？  
A：可以，设置 extract_mode = "all_free"。

Q：支持模组物品吗？  
A：支持，使用完整物品 ID（如 modname:itemid）。

Q：需要客户端装模组吗？  
A：不需要，纯服务端。

---

链接

GitHub: https://github.com/KlN-4096/recyclingservice

---

许可

GPL-3.0（见 LICENSE）