In this article we gathered a list of error messages that you may encounter when using the CurseForge app, and solutions that can help solve them.


Take me to...


General

An error has occurred. Please check your connection and try again.

Please make sure your network connection is working properly:

  1. Antivirus and other types of software

    If you're using an antivirus or other types of software that could affect your network connection, please disable them temporarily and check if there's any change with the issue.

  2. VPN

    Try to temporarily disable any VPN programs you have running, as they may interrupt the connection required for CurseForge to install the necessary Java or Forge files.

  3. Proxy

    If you have a proxy connection set up on your system, please try to temporarily disable it to check if it has any effect on the issue. You will need to make sure both "Use setup script" and "Use a proxy server" are disabled.

    Windows 10




    Windows 11




  4. Hosts File

    Follow Microsoft's guide, How to reset the Hosts file back to the default.

  5. Private Relay (macOS)

    If you're using CurseForge on macOS, try to temporarily disable the Private Relay option located under iCloud.

Otherwise, this could be a server issue on our side - you can check the CurseForge Twitter for any related updates, or reach out to us for help.


An unexpected error occurred. Operation failed

This error requires some looking into.

Please reach out to us for help and attach your logs - this will help us determine the cause and get closer to a solution!


Check category or game version filters and try again

This error requires some looking into.

Please reach out to us for help and attach your logs - this will help us determine the cause and get closer to a solution!


Failed to delete addon(s)

Please try restarting the app, or repairing the folder permissions, for example:



If neither helps, it's possible that the addon's file is currently locked - make sure that the game (or any other program that could be using the file) isn't running. You can also use software like LockHunter to 'unlock' and delete the file.


Failed to save instance settings

If CurseForge was unable to save the change you made in an instance name, please reach out to us for help.


General install error

Please make sure your network connection is working properly.

Otherwise, this could be a server issue - you can check the CurseForge Twitter for any related updates, or reach out to us for help.


I/O error occurred

This error requires some looking into.

Please reach out to us for help and attach your logs - this will help us determine the cause and get closer to a solution!


Missing required disk permissions for installation

Minecraft

Please make sure that your antivirus software is not blocking any files downloaded or used by the app.


Other Games

Please try restarting the app, or repairing the folder permissions, for example:



Oops, that was not supposed to happen!

Please follow these instructions.


Something went wrong, please try again

This error requires some looking into.

Please reach out to us for help and attach your logs - this will help us determine the cause and get closer to a solution!


Sorry, we can’t load this project. Missing dependency: {{context}}

Missing dependencies.


This game is already being tracked by the CurseForge App

The game you are trying to detect is already tracked by the app, and it cannot be added again.


This is an invalid directory or unsupported game

Please make sure to select the folder than contains the game's executable file.

For example, World of Warcraft instances should be added according to the specific installation (Retail/Wrath of the Lich King Classic/Classic). For Retail, the folder _retail_ should be selected.


Minecraft

An access violation occurred when attempting to install Minecraft launcher

Please make sure that your system user has sufficient permissions (read/write) to the modding folder, or try installing the modding folder on a different drive.


Still not working?

Please reach out to us for help and attach your logs - this will help us determine the cause and get closer to a solution!


An invalid folder path was chosen

Please follow these instructions.


An unexpected error occurred while trying to install Minecraft

This error requires some looking into.

Please reach out to us for help and attach your logs - this will help us determine the cause and get closer to a solution!


CMD configuration may be causing issues

Please follow these instructions.


Failed to create Minecraft directories

This error requires some looking into.

Please reach out to us for help and attach your logs - this will help us determine the cause and get closer to a solution!


Failed to download the Minecraft launcher due to a network error

Please make sure your network connection is working properly.

Otherwise, this could be a server issue - you can check the CurseForge Twitter for any related updates, or reach out to us for help.


Failed to find Minecraft process

Please try repairing the installation:



Failed to install Minecraft launcher

Please try repairing the installation:



Or installing a modpack with a different modloader type (Forge/Fabric) or version.


Still not working?

Please reach out to us for help and attach your logs - this will help us determine the cause and get closer to a solution!


Failed to set installation path

Installation path might include special characters / desktop was chosen / invalid path was chosen for some reason.

Try to go for a generic modding path.

  • Modding folder cannot be set in a root drive
  • Modding folder cannot be set in desktop folder
  • Modding folder cannot be set on OneDrive
  • Modding folder cannot be set in Minecraft installation
  • Warning: Disk is low on storage, you may not be able to install new modpacks
  • No folder permissions
  • Path can only include English letters and numbers

Failed to unzip Minecraft launcher

This error requires some looking into.

Please reach out to us for help and attach your logs -  this will help us determine the cause and get closer to a solution!


Invalid file

The app's 'Import' option only works with modpacks (not individual mods, or any other type of content) that were exported according to the CurseForge standard.


Java Runtime Environment is missing or out of date

Please try repairing the installation:



Missing required disk permissions for installation

If in a non-minecraft game -> Repair folder permissions 

If in Minecraft -> Probably an antivirus or a file is being blocked for some reason.


Modloader installation failed

Please try the 'Repair installation' option:



If that doesn't fix the issue, please make sure your network connection is working properly.


Modpack [modpackName] ([modpackId]/[fileId]) was not found

Please reach out to us and send us the full error message (in writing or in a screenshot) and we will fix it!


Profile name should not include special characters

Please select a different name for the profile that doesn't contain special characters like * [ /


Unsupported mod loader

The modloader you're attempting to install in not compatible with the selected Minecraft version.
Please try a different version of the modloader, or a different modloader type.


You need at least 10GB to install new modpacks. Clear some disk space or change folder

Please clear some space in your hard drive or select a different drive for modding.


World of Warcraft

Failed to create [groupName] sync group. The group name already exists

You already have a sync profile with this name. Please select a different one :)


Other

Installation failed - SMAPI is required

Please make sure you have SMAPI installed, according to the instructions.