世界文件清理器

世界文件清理器

服务器停止时清理世界文件

优化

World File Cleaner – 自动清理存档文件

World File Cleaner 是一个简单的 Fabric 模组,可在服务器关闭或退出单人世界时,自动从世界存档文件夹中删除不必要的文件,帮助保持存档文件夹整洁并减少磁盘占用。

✨ 特性

  • 在专用服务器关闭或单人世界卸载时自动执行清理。
  • 可配置删除文件/文件夹(例如日志、缓存、会话锁、统计数据等)。
  • 默认安全:仅删除非关键文件(除非你自行配置,否则不会删除区域文件或玩家数据)。
  • 同时支持服务器和客户端(单人模式)。

📦 兼容性

  • Minecraft 版本:1.21.11
  • 模组加载器:Fabric
  • 使用 ModMenu

⚙️ 配置文件

首次运行后,将在以下路径生成配置文件:

config/autoclean.json

配置示例:

{
	"worldFileEnabled": true,
	"worldFileDeletePatterns": [
        "session.lock"
	],
	"serverFileEnabled": true,
	"serverFileDeletePatterns": [
		".cache",
		"logs"
	],
	"whiteList": [
		"latest.log"
	]
}
  • worldFileEnabled:世界文件开关。
  • worldFileDeletePatterns:要删除的世界存档文件夹内的文件。使用 * 作为通配符。
  • serverFileEnabled:游戏文件开关。
  • serverFileDeletePatterns:要删除的游戏根文件夹内的文件。使用 * 作为通配符。
  • whiteList:删除白名单,优先级更高。
> 💡 **警告**:删除区域文件(*.mca)或 playerdata 将导致游戏进度丢失。这些文件已从默认配置中排除。

## ⚠️ 重要说明
- 首次使用自动删除功能前,**请务必备份**你的世界存档。
- 本模组**不会**删除存档文件夹本身——它只会删除其中的指定文件。
- 在专用服务器上,本模组只需在服务器端运行;客户端无需安装即可使服务器端清理正常工作。

## 📄 许可证
本模组基于 MIT 许可证开源。