Launcher screen is blank (grey/black)

Possible solutions

• Repair the installation
  
  
  
  
• If you have an NVIDIA GPU - try updating or downgrading the version of your NVIDIA drivers.

Couldn't load launcher core from... / Unable to start the Minecraft Runtime Environment

Possible solutions

• Repair the installation
  
  
  
  
• Close/disable any programs or configurations that might affect the Minecraft launcher's connection:
  • Antivirus
  • VPN
  • Proxy connection
  • Content filter
    
    
• Try resetting the system’s hosts file:
  • Windows: https://support.microsoft.com/en-us/topic/how-to-reset-the-hosts-file-back-to-the-default-c2a43f9d-e176-c6f3-e4ef-3500277a6dae
  • Mac: https://support.apple.com/en-us/HT203213#hosts
    
    
• Try connecting to a different network/a mobile hotspot
  
  
• Check if the issue reproduces in the Minecraft legacy launcher (the same launcher that CurseForge installs).
  You can download it here: https://www.minecraft.net/en-us/download
  
  

Can’t login to Minecraft account / getting logged in to the wrong account

This can include any of the following:

• Error messages that show up when trying to login
• Logging into an incorrect account/game profile
• Launcher not detecting a Minecraft Java license or game profile

Possible solutions

• Repair the installation
  
  
  
  
• Delete the launcher_accounts.json file in the modding directory, under 'Install'
  
  
  
  
• Try to login to the account in the game's website and make sure you can see your Minecraft Java profile there: https://www.minecraft.net/en-us/login
  
  It should show like this:
  
  
  
  
• Check if the issue reproduces in the Minecraft legacy launcher (the same launcher that CurseForge installs).
  You can download it here: https://www.minecraft.net/en-us/download
  
  

Launching the game failed!

These are errors that often pop up after pressing 'Play' in the game's launcher, and can refer to various files and kinds of issues.

Possible solutions

• Repair the installation
  
  
• Close/disable antivirus and VPN software
  
  
• Try resetting the system’s hosts file 
  • Windows: https://support.microsoft.com/en-us/topic/how-to-reset-the-hosts-file-back-to-the-default-c2a43f9d-e176-c6f3-e4ef-3500277a6dae
  • Mac: https://support.apple.com/en-us/HT203213#hosts
    
    
• Try connecting to a different network/a mobile hotspot and check if the issue reproduces:
  • The issue doesn't reproduce
    This means that the problem is most likely with the network you're normally connected to. It can be related to router settings, a content filter or even a block on the ISP's (internet service provider) side.
  • The issue reproduces
    This means that the problem is most likely local, related to your system. Other than what was mentioned previously, this could be related to a proxy connection, programs that affect connection (like Intel's Killer software), DNS, IPv6, etc.
    
    
• Check if the issue reproduces in the Minecraft legacy launcher (the same launcher that CurseForge installs).
  You can download it here: https://www.minecraft.net/en-us/download
  
  

"Incompatible with launcher" instead of "Play" button

Switching from "Minecraft for Windows" to "Minecraft: Java Edition" should bring you to the right place:

Can only play Demo

If you're launching a modpack but the game's button says 'Play Demo' (instead of 'Play'), like so:

Please try to log out and back in:

In-game issues (crashes, glitches, world issues, etc.)

Anything that happens after clicking 'Play' in the Minecraft launcher.

Since there's a bunch of types of issues, we will only be addressing the most common ones we've been receiving from users.

Exit code 1

This is a general error for various kinds of game crashes:

Possible solutions

• If every modpack/custom profile is crashing:
  • Repair the installation
    
    
  • Make sure that your GPU drivers are up to date. It's best to check the manufacturer's website (NVIDIA/AMD/Intel) because the system might not be reliable when it comes to GPU drivers.
    
    
  • Check if the crashes occur only with a specific modloader.
    If so, please reach out to the modloader's developers for further help:
    • Forge: https://files.minecraftforge.net/net/minecraftforge/forge/
    • Fabric: https://fabricmc.net/
    • Quilt: https://quiltmc.org/en/
    • NeoForge: https://neoforged.net/
      
      
  • Create a custom profile and run it without any mods installed, to check if it crashes or not.
    If it crashes, this means that the issue is related to the modloader or to the game.
    
    You can ask the Minecraft modding community for further help in the #minecraft-support channel over at the CurseForge Discord server.
    
    
• If only certain modpacks/custom profiles are crashing, try to reinstall or repair them:
  
  
  If the modpack still crashes, please reach out to the modpack's authors for help.

Graphic glitches, sound issues, etc.

This includes any issues within the game itself, like textures glitching, incorrect colors, sounds not working properly, etc.

Possible solutions

• Repair the installation
  
  
  
  
• Make sure that your GPU drivers are up to date. It's best to check the manufacturer's website (NVIDIA/AMD/ Intel) because the system might not be reliable when it comes to GPU drivers.
  
  
• Check if the issue reproduces in the vanilla Minecraft. If it doesn't, it means that the issue is likely related to installed mods.

World cannot be created/crashes

Issues with worlds can be related to the modloader, the mods or to the game itself.

Please reach out to the authors of the mod/modpack you're playing for help troubleshooting the issue.

Minecraft isn't running with my main/dedicated GPU

Please follow this guide: How to make it so Minecraft Java Edition would run on my NVIDIA GPU - Microsoft Community

For step 7 - 'Select Minecraft and click Add', please select the minecraft.exe file that is located in the 'Install' folder of your modding directory (default: C:\Users\[user]\curseforge\minecraft\Install\minecraft.exe):

Game servers

Game servers run independently of CurseForge and therefore we cannot assist with issues that are related to them.

Please reach out to the server owner or to the server-hosting service for help.

Mod/modpack/custom profile issues

This includes the functionality of mods/modpacks/custom profile in-game including crashes and errors.

Please note that we cannot help with the process of assembling mods for custom profiles or with troubleshooting them.

• Reinstall the mod/modpack or repair the modpack/custom profile
  
  
  
  
• Reach out to the authors of the mod/modpack