原创 工具 Chunkyclean - 安全清理长期未活跃区块的 Paper 插件 1.0

Chunkyclean

Chunkyclean 是一个偏保守策略的区块清理插件，目标不是"暴力删区块"，而是通过持续记录区块活跃度，筛出长期无人活动、又不处于保护范围内的区块，再按配置执行清理。

适合哪些服务器

• 生存服
• 长期开服导致地图逐渐臃肿的服务器
• 希望控制区块清理风险、避免误清的运维环境
• 需要先观察后上线正式清理策略的服务器

核心机制
插件会记录以下活跃行为：

• 玩家进入或访问区块
• 玩家打开容器
• 红石活动

随后按定时任务扫描已加载区块，并结合以下条件决定是否跳过：

• 世界白名单
• 出生点保护半径
• 玩家附近区块保护
• 强制加载区块保护
• Tile Entity 保护
• 命名实体保护
• 指定方块 / 实体黑名单保护
• 手动矩形保护区域
• WorldGuard / Residence / GriefPrevention 保护判断

如果区块长期未活跃，会先进入候选期；候选冷却结束后，才会真正执行清理动作。

支持的清理动作

1. unload
安全卸载区块，适合绝大多数正式服务器。

2. regenerate
重生区块，风险更高，适合明确知道自己要做什么的场景。

存储与日志
插件支持两种存储方式：

• 文本存储
• SQLite 存储

同时支持从旧文本记录自动迁移到 SQLite。

每次真正执行清理，都会写入审计日志，方便后续排查：

为什么更安全
Chunkyclean 不是直接操作 region 文件，也不会做不安全的异步世界访问。它基于运行时 Paper API 在主线程中执行清理逻辑，更适合对稳定性和兼容性有要求的多人服务器。

默认建议
首次上线时请保持：
先观察日志、候选区块和跳过原因，确认配置没有问题后，再切换为真实清理。

安装说明

1. 将插件放入 plugins 目录
2. 启动服务器生成配置
3. 调整以下配置文件
   • config.yml
   • cleanup.yml
   • protection.yml
   • storage.yml
4. 首次上线建议保持 dry-run
5. 观察一段时间后再开启真实清理

命令说明


权限节点


注意事项

• 插件当前定位是"安全优先"，不是"激进清图"
• 默认只评估已加载区块
• 正式服建议优先使用 unload
• 正式启用前建议至少经历一次 dry-run 观察期
• 如果你服务器已经使用 WorldGuard、Residence、GriefPrevention，建议保留对应兼容开关

更新日志首发文案

v1.0.0

• 首次发布
• 支持区块活跃度追踪
• 支持 unload / regenerate 两种清理动作
• 支持 SQLite 与文本存储
• 支持旧记录自动迁移
• 支持 WorldGuard / Residence / GriefPrevention 兼容保护
• 支持 dry-run 预演与审计日志