If Minecraft Java Edition stops at an “Unable to Prepare Downloading Assets” message, the launcher has not finished preparing files needed to start the selected game version. Begin with the network and launcher checks below. If they do not help, safely rebuild the local asset cache by renaming its folder so the launcher can download it again. This guide covers the official desktop launcher; Bedrock Edition uses a different app and does not use the same Java assets folder.
The message alone does not show that a world is damaged or that a specific Minecraft version is broken. Work through the fixes in order, and stop when the game opens. Avoid deleting the entire .minecraft folder: that can remove worlds, screenshots, resource packs, and settings along with cached files.
Java Edition keeps downloadable game resources in an asset cache. During launch, the launcher checks and retrieves files required by that version. A connection interruption, blocked download, incomplete local cache, or launcher problem can prevent this preparation from finishing. The wording can vary by launcher build, and it is not a diagnostic code that identifies one cause on its own.
These steps focus on the Minecraft Unable to Prepare Downloading Assets error and the related Minecraft assets download error. They do not assume that every case comes from a corrupted folder, a Mojang outage, a mod, or a particular Java release.
Make sure you are launching Minecraft: Java Edition. On Windows, the default game directory is usually %appdata%\.minecraft. On macOS, it is usually ~/Library/Application Support/minecraft; on Linux, it is usually ~/.minecraft. If you changed the Game Directory in a Java installation or use a third-party launcher, use that installation’s actual game directory instead. Do not apply the Java cache steps to Bedrock, consoles, or mobile.
If you have important worlds, make a separate copy of the saves folder before troubleshooting. It is not the assets cache, but a backup is sensible before working inside any game directory.
Do not turn off your firewall or antivirus as a routine fix. If security software reports a specific block, use its documented allow-list controls for the official launcher and restore your normal protection. A speed-test number by itself cannot confirm that Minecraft’s download endpoints are reachable.
Install any available Minecraft Launcher update, close the app completely, and restart the computer if the update requests it. On Windows, check the Microsoft Store’s Library for Launcher updates. If you need the installer, use the official Minecraft download page, not a third-party download mirror.
Check that the Launcher is signed into the Microsoft account that owns Minecraft or has the relevant subscription. Minecraft’s Launcher troubleshooting guidance recommends checking the signed-in account and reinstalling the Launcher when ordinary troubleshooting does not resolve a Launcher issue. Sign out and back in only if the account shown is wrong or the session appears stale.
This reversible Minecraft assets error fix tests whether a local cache is incomplete. The cache can be downloaded again; renaming it preserves a fallback copy while you test.
assets.assets to assets.old. Do not rename or delete saves, and do not remove the whole game directory.If the game starts, keep assets.old until you have confirmed the game and your worlds open normally; then you can remove that backup to free disk space. If the error remains, close the Launcher. If a new assets folder was created, move that new folder aside, then rename assets.old back to assets. This returns the cache to its previous state.
If there is no assets folder, or your launcher manages shared files in a custom location, do not guess at another folder to delete. Use the launcher’s documented repair or instance tools instead.
A new profile can help tell whether the problem is tied to one installation’s settings, mods, or custom game directory. In the Minecraft Launcher, select Minecraft: Java Edition, open Installations, choose New installation, and select the same game version as the failing profile. Give it a temporary name and leave advanced settings at their defaults. Do not delete your existing installation or world.
Try launching this clean profile. If it works, compare the old profile’s game directory, mod loader, mods, and custom JVM arguments one at a time. For a modded game, make a separate vanilla test with the same base Minecraft version before changing mods. Minecraft Help describes a new Java installation as a way to test whether an existing installation is causing a launcher crash; it is a useful isolation check, not proof that every asset error has the same cause. See Minecraft’s instructions for creating a new Java installation.
On Windows, open Settings > Apps > Installed apps, find Minecraft Launcher, and open Advanced options if available. Select Repair first. Microsoft says Repair can address app problems; Reset is a separate option that restores default app state and may remove app data. Use Reset only after Repair fails and you understand the sign-in or app-state effects. The current steps are in Microsoft’s Windows app repair guide.
If Repair is missing or does not help, reinstall the Launcher from the official Minecraft download page or Microsoft Store. Reinstalling the Launcher is different from deleting .minecraft; keep the game directory unless official support tells you otherwise. On macOS or Linux, reinstall the Launcher from its official source without removing your Java game folder.
| What happens | Next check |
|---|---|
| Every Java version fails at asset preparation | Check network access, free disk space, and the shared asset cache. |
| Only one installation fails | Test a clean profile and compare that installation’s directory, mods, and launch settings. |
| Vanilla works but a modded profile fails | Check the mod loader and mods for that exact Minecraft version. |
| The Launcher itself will not update or install | Follow the separate official Launcher installation troubleshooting guide. |
Record your operating system, Launcher version, Java Edition version, whether you use mods, and the exact error text. If the game produced a log, the Java latest.log file is usually inside the logs folder of the selected game directory. Share it only with Minecraft Support or a trusted technical helper, and remove account names, personal file paths, or other identifying details first. The Minecraft Help Center is the official place to look for Launcher support and submit a request.
For Bedrock Edition, use the repair, update, or reinstall options for the relevant platform app and follow Bedrock-specific support instructions; do not search for a Java assets folder. Avoid routine monthly cache deletion, editing the Windows hosts file, or installing an unrequested Java runtime as blanket fixes. Change only the component that your test points to.
Enable Server Latency and Packet Loss in Warzone to monitor connection quality, read the overlay, and use recurring spikes to guide troubleshooting.
Learn how to carry from mid lane in League of Legends by setting up waves, choosing safe roam windows, reading side lanes, and converting pressure into objectives.
Fix Minecraft Evoker spell problems with a safe vanilla test, version checks, log review, and a step-by-step way to isolate mod or datapack conflicts.
Fix PUBG stuck on Initializing on Steam with a focused checklist for PC service notices, launch options, game files, downloads, and connection issues.
Fix Brawl Stars stuck at 92% loading with an ordered checklist for service notices, network tests, safe updates, Android cache, and account-safe reinstalling.
Best Dead by Daylight visual filter settings start with a small Gamma lift, neutral color and contrast, and a quick check for dark corners, fog, and bright lights.
Find the Steam and EA app fields for Apex Legends launch options, use EA’s documented FPS command, and see why +exec autoexec.cfg remains unverified.
Reduce input lag on a Nintendo Switch dock for Smash Ultimate with TV Game Mode, a direct HDMI test, controller checks, and online-latency troubleshooting.
Find the best EA SPORTS FC audio settings for a clearer referee whistle: tune Stadium Ambience and Commentary, then troubleshoot output or timing issues.
Compare the best Attack Move Click keybinds in League of Legends—A, Shift + right-click, mouse side buttons, and left-click—with setup and kiting tips.
