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:

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.