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）