Troubleshooting
Repair, crashes, logs, sign-in messages, the sandbox, and asking for help.
Repair #
Repair... is in an instance's menu. It clears the loader's caches and the version's unpacked native files, which a full disk or a crash can leave half-written. The next Play rebuilds them and checks every game file. Your worlds and settings stay.
A modpack instance also has Repair from the modpack: it lists the files that were changed, removed or added compared with the pack, finds which pack version a stale file came from, and keeps your worlds.
The game crashed #
- The launcher reads the crash and names what it points to: a mod, a missing dependency or the wrong Java.
- If an update caused it, roll it back from Updates > History (Finding content).
- If you turn on crash analysis by mclo.gs, the log is also sent there and the problems it finds are shown.
Logs #
An instance's Logs tab shows the live log while it plays and the logs of past sessions, with search, a level filter (warnings, errors) and fullscreen. It reads logs of any size and follows latest.log across restarts. While the game runs it shows CPU, memory against what it was given, threads and run time, with two-minute graphs.
Share uploads a log to mclo.gs and gives you a link. Tokens, e-mail addresses and IP addresses are hidden first.
Messages when you press Play #
| Message | What to do |
|---|---|
| Sign in with a Microsoft account that owns Minecraft to play. | Sign in (Getting started). The message opens the sign-in dialog. |
| This app isn't approved for Minecraft sign-in yet. | Minecraft refused the launcher's app, not your account. Nothing to fix on your side: say so on Discord. |
| Sandbox unavailable | The sandbox can't run here. Under Untrusted instances the instance plays without it; under Always, or with the instance set to On, use Sandbox options to change that. |
| A Java is missing | The launcher offers to get it, or to point it at one you have. |
| Low memory | Play anyway, change the memory, or don't ask again. |
A mod misbehaves in the sandbox #
Links and Open folder buttons inside the game don't work sandboxed, and nor does Realms. A mod that needs Discord, Downloads or Documents needs its switch in Settings > Privacy. Otherwise set Sandbox this instance to Off in the instance's Options. See Sandbox and privacy.
Stopping a game #
The stop button beside a playing instance ends it. If the launcher itself closes or crashes while you play, it finds the game again when it starts, so the stop button keeps working.
Asking for help #
- Report a problem sends a report about the launcher's own problem: what failed, the launcher's version, your system, and what you were doing if you write it. Names, folders and addresses are taken out, and you see all of it before you click Send.
- You can also export debug info as a ZIP to share.
- Or ask on Discord.
Something missing or wrong on this page? Say so on Discord.