Skip to content

World File Cleaner

clean world files when server stop

Fabric
Loaders
Fabric
Downloads on Modrinth
216
Followers on Modrinth
0
version
1
Updated
May 3, 2026May 3
Published
in 2026

At a glance

Runs on Fabric
For Minecraft 1.21.11
Server only — players don't need to install it
Latest version — 1.4.2 from May 3, 2026
License MIT — free
Where it's needed
In gamenot neededOn serverrequired

Install on the server only; players don't need it

Game versions1.21.11

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.

FAQ

How to install World File Cleaner?

Install Fabric for your Minecraft version, download World File Cleaner for the same version and loader, put the file into the mods folder and launch the game with the loader profile.

Which Minecraft versions does World File Cleaner support?

World File Cleaner has builds for Minecraft 1.21.11.

Is World File Cleaner needed on the server?

Server only — players don't need to install it

License and source
MIT Licensefree to use and share with credit to the author
Original — Modrinth↗Files unchanged, verified with SHA-512Is this your mod? For rights holders

The site uses cookies: the necessary ones for sign-in and the theme, plus the Yandex Metrica and LiveInternet visit counters — they show us how the site is used. We have no advertising cookies. More