CacheUtils
A client side debugging tool for data pack and mod developers alike that adds commands for interacting with the texture cache
About this Mod
Cache Utils Documentation
Description
Cache Utils is a lightweight, client-side utility mod designed for resource pack creators and mod developers to debug and visualize cached assets in real-time.
It adds a single core command with multiple sub-commands that allow you to interact with the cache
Commands:
/cacheutils delete <target> [<protectUI>]
What it does: Removes all cache entries whose keys contain the specified <target> string.
Usage notes: <target> determines which entries get deleted — anything containing that substring will be deleted; use with caution. <protectUI> (default: true) prevents deleting font-related cache entries. Disabling this may break visible UI elements until the player uses F3+T, which restores fonts but not other assets.
/cacheutils info <target> [<ordinal>]
What it does: Shows the full cached value for the specified <target>. If multiple entries match, optionally include <ordinal> to pick the exact entry.
Usage notes: Use this to inspect the raw stored data for a target. Helpful when you need technical information about an entry.
/cacheutils length
What it does: Displays the total number of entries currently stored in the cache.
Usage notes: No parameters accepted — it simply returns the count. Great for quick sanity checks.
/cacheutils list <chat|log> [<searchTerm>]
What it does: Lists cached entries from the chosen output mode: chat (prints to player chat) or log (writes to the server log). Optionally provide <searchTerm> to filter results.
Usage notes: Use chat for quick interactive results, and log when you need long output or for sharing with devs.
Warning
The delete sub-command will in fact delete vanilla Minecraft textures if you tell it to do so. This is not a bug, this is by design of the mod. There are some textures that have been forcefully prevented from being deleted: minecraft:missingno, and there are some that have been put under security - fonts - to delete these textures you must set [
Development
This mod is still under development, and will be getting new features and ported to new and old versions IT WILL NOT BE PORTED TO FORGE OR NEOFORGE unless some writes it for that mod loader and makes a pull request on my git repo.
Available Versions
How to Install CacheUtils on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set fabric Loader
In the panel under "Egg", select the fabric loader and matching Minecraft version (1.21.8).
Install Mod
Open the mod browser in the dashboard and search for "CacheUtils". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.8, 1.21.7, 1.21.6 (+2 more)
Server-side
✗ UnsupportedRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
CacheUtils server crashes on startup – what to do?
Most common cause: wrong fabric version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.8). You can switch loaders with one click in the panel.
Is CacheUtils compatible with fabric?
CacheUtils officially supports fabric for Minecraft 1.21.8, 1.21.7, 1.21.6. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with CacheUtils – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if CacheUtils consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install CacheUtils with just one click on your server.