World File Cleaner

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: ```text config/autoclean.json ```

Example configuration: ```json { "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

- does not 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.