ModsFinder

World File Cleaner

by Wang125510

World File Cleaner removes non-critical leftover files from a Fabric world when a dedicated server stops or a single-player world unloads.

FabricServer-side onlyMIT LicenseOpen source1.21.11

What it does

Once the server halts or a single-player save is closed, the mod runs a cleanup pass over the world folder. The set of files and folders it deletes is configurable, and the author lists logs, caches, session locks and statistics as examples. By default it removes only non-critical files; region files and player data are kept unless the server owner changes the configuration.

The mod supports dedicated servers as well as single-player and client sessions, so the same cleanup applies in each mode. A world file switch in the configuration turns the feature on or off. The configuration screen is reached through Mod Menu, which is an optional dependency and can be left out. The mod is published for Fabric only, for Minecraft 1.21.11, and is released under the MIT License, so the source code is open source.

Key features

  1. Cleanup on shutdown

    The cleanup runs automatically when a dedicated server stops or a single-player world is unloaded, with no command needed.

  2. Configurable deletion list

    Files and folders such as logs, caches, session locks and statistics can be added or removed from the deletion list.

  3. Safe defaults

    Out of the box only non-critical files are deleted, and region files and player data stay in place.

  4. World file switch

    A worldFileEnabled option lets an operator turn world file cleanup on or off in the configuration.

Compatibility

Latest build for each game version and loader.

1.21.111.4.2
ReleaseBetaAlphaNot available

Only full game releases are shown. This mod publishes no snapshot builds.

Requirements

Dependencies declared by the latest file for each loader.

Optional 1

Mod MenuAdds a mod menu to view the list of mods you have installed.
Optional

Use cases

Who it’s for: Server owners who want leftover logs, caches and session files cleared each time a server stops, and players who manage many single-player worlds on Fabric.

Questions

Does World File Cleaner need Mod Menu?

No. Mod Menu is an optional dependency. It is only needed to open the configuration screen from the in-game mod list.

Does World File Cleaner have to be installed on the client?

No. Players join without it, since only the server has to run the mod.

Will the cleanup delete player data or region files?

Not with the default settings. Only non-critical files are removed unless the server owner configures the deletion list to include more.

Which Minecraft versions does World File Cleaner support?

The mod is published for Minecraft 1.21.11 only, with the latest Fabric file 1.4.2 for 1.21.11.

In the catalog

World File Cleaner is one of 3,545 Optimization mods on ModsFinder, and one of 2,575 Optimization mods for Fabric. 19,862 mods support Minecraft 1.21.11.

More from Wang125510

All projects

Similar mods

Official listing

Owner
Wang125510
Published
2026-05-03
Updated on Modrinth
2026-05-03
Facts verified
2026-10-15

Tags