World File Cleaner – Automatic Save File Cleanup

World File Cleaner is a simple Fabric mod that automatically deletes unnecessary files from your world save folder when a server shuts down or a single-player world is exited, helping keep your save folder tidy and reducing disk usage.

✨ Features

Automatically performs cleanup when a dedicated server shuts down or a single-player world is unloaded.
Configurable deletion of files/folders (e.g., logs, caches, session locks, statistics, etc.).
Safe by default: only non-critical files are deleted (region files or player data will not be removed unless you configure it yourself).
Supports both server and client (single-player mode).

📦 Compatibility

Minecraft Version: 1.21.11
Mod Loader: Fabric
Using ModMenu

⚙️ Configuration File

After the first run, a configuration file will be generated at the following path:

config/autoclean.json

Example configuration:

{
	"worldFileEnabled": true,
	"worldFileDeletePatterns": [
        "session.lock"
	],
	"serverFileEnabled": true,
	"serverFileDeletePatterns": [
		".cache",
		"logs"
	],
	"whiteList": [
		"latest.log"
	]
}

worldFileEnabled：Switch for world files.
worldFileDeletePatterns： Files within the world save folder to be deleted. Use * as a wildcard.
serverFileEnabled：Switch for game files.
serverFileDeletePatterns： Files within the game root folder to be deleted. Use * as a wildcard.
whiteList：Deletion whitelist, takes higher priority.

> 💡 **Warning**: Deleting region files (*.mca) or playerdata will result in lost game progress. These files are excluded in the default configuration.

## ⚠️ Important Notes
- **Always back up** your world save before using the automatic deletion feature for the first time.
- The mod **does not** delete the save folder itself – it only removes the specified files within it.
- On dedicated servers, the mod only needs to run on the server side; clients do not need to install it for the server-side cleanup to work properly.

## 📄 License
This mod is open-sourced under the MIT License.