Skip to content

Troubleshooting

kz6fittycent edited this page Nov 3, 2026 · 1 revision

Troubleshooting

The launcher

You see What to do
Download failed! Please check your internet connection and retry. Check your internet connection and press Retry Download.
Nothing happens when you open Minecraft Run mc-installer in a terminal and look at what it prints. Include that if you open an issue.
The launcher asks you to sign in every time Open an issue with your Linux version (lsb_release -a).
Clicking in the launcher does nothing, or menus close by themselves Try the Tab and Enter keys to get through, and open an issue saying which graphics card you have.

The game

You see What to do
The game window is see-through or black Update the snap (sudo snap refresh mc-installer); versions before 14.3 had this problem on some NVIDIA PCs.
On a laptop with two graphics cards, the game is slow Right-click Minecraft in the app grid and choose Launch using Discrete Graphics Card.
Couldn't load Narrator library in the logs Harmless: only the narrator (text-to-speech) is affected.
The game closes straight after starting Look at the last lines of logs/latest.log (see Files and Backups). With mods, it usually names the mod at fault.

Servers

You see What to do
Incompatible version or Outdated client/server Play the server's Minecraft version: see Playing on a Server.
Connection Lost mentioning registry entries, or a mod The server needs a mod you don't have: see Mods, Joining a server that has mods.
Can't connect to server Check the address, and that the server is running. At home, both computers must be on the same network.

Mods

See the table at the end of Mods.

Still stuck?

Open an issue and include:

  • what you did and what you saw (a screenshot helps)
  • snap info mc-installer | tail -3 (which version you have)
  • for game problems, logs/latest.log

Clone this wiki locally