clean up your mess 2

Clean Up Your Mess (Client)

Find and safely remove leftover files from mods you no longer use, right on your own game install.

When you remove a mod, its config files, folders and data usually stay behind. Over time your config/ folder and game directory fill up with leftovers from mods you uninstalled long ago. Clean Up Your Mess (Client) finds these orphaned files and lets you move them to a quarantine folder. Nothing is ever deleted.

This is the client-side version. Put it in your modpack or mods/ folder, not on the server. A separate server version exists for server-side cleanup.

✨ Features

• Smart detection: compares file and folder names with the IDs, names and provides entries of every loaded mod. If in doubt, the file is kept.
• Scans two places:
  • your config/ folder
  • your game or instance folder (.minecraft, CurseForge, Prism/MultiMC, Modrinth App…)
• Safe by design:
  • built-in allowlist for Minecraft and launcher files (saves, resourcepacks, shaderpacks, screenshots, options.txt, servers.dat, launcher instance files, defaultconfigs, global_packs…)
  • ignores logs, archives, images, executables and jars
  • knows common shared folders (Iris/Oculus, Sodium, schematics from Litematica/WorldEdit/Axiom, Emotecraft, Patchouli books…)
  • never scans your singleplayer worlds
• Nothing moves without your say-so: a background scan runs at startup. If leftovers are found, you get a single chat message with a [View list] button when you join a world or server.
• Quarantine, not deletion: files are moved into batches you can restore at any time.
• Reports: each scan writes a readable report, and clickable buttons open the folders directly.
• English & French: follows your game language automatically.

🧭 Commands

The command is named differently from the server’s /cleanup so staff can use both.

⚙️ Configuration

config/cleanupyourmess-client.json

• language: auto / en / fr
• scanOnStartup, notifyInChat
• scanConfig, scanGameFolder
• quarantineFolder, reportFolder
• listValidityMinutes: how long a list stays valid before apply
• protectedItems: files or folders that are never flagged

Quarantined files go to cleanupyourmess/quarantine/<batch>/ (with a batch.txt summary). Reports go to cleanupyourmess/reports/.

📦 Requirements

• Minecraft 1.21.1
• Fabric Loader
• Fabric API

Made for the Dynasty Craft server.