This article provides a comprehensive list of error messages you may encounter while using the CurseForge app, along with troubleshooting steps to help resolve them.


Take me to...

General Errors

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

Ensure your network connection is stable. If you use antivirus, VPN, or proxy tools, try disabling them temporarily:


  • Antivirus/Firewall: These may interfere with the connection. Disable temporarily to test.
  • VPN: Disable any VPN software and try again.
  • On Windows, refer to Microsoft’s article on resetting the Hosts file.
  • Proxy Settings: Ensure “Use setup script” and “Use a proxy server” are both disabled.
    Windows 10:


    Windows 11:


If you're on macOS, disable Private Relay under iCloud. 


If the issue persists, it could be server-side. Check CurseForge X/Twitter & CurseForge Discord for updates or contact support for assistance.


An unexpected error occurred. Operation failed.

Verify that your Windows user has full control over the game’s mods folder:

 

If the issue continues, contact support and include your logs.


Check category or game version filters and try again.

This issue may require support assistance. Please contact support and include your logs.


Failed to delete addon(s)

Please try the following:

  1. Restart the app
  2. Repair folder permissions
  3. Make sure that the game's process isn't still running (using the system's Task Manager)
  4. Restart your system

 

Failed to save instance settings

If saving a setting change fails, contact support for assistance.


Game not found

This message appears when:

  • The selected folder does not contain the game’s exe (executable file).
    Please make sure to select the game's installation folder (the folder that contains the game's .exe/.app file), not the game's mods installation folder.
  • The game is not supported by the CurseForge app. Refer to the list of supported games Here.


General install error

Possible causes:

  • Network Issues: Check your connection.
  • Low Disk Space: Ensure enough free space on both your system and modding folders.
    The app first downloads mod files to the local %temp% folder (which is usually located in the hard drive where the operating system is installed), and later moves them to their final destination.
  • Server Errors: Check CurseForge X/Twitter & CurseForge Discord for updates.


I/O error occurred

This typically means the app can’t interact with local mod/addon files:

  • Check for services like OneDrive or iCloud that may be locking files.
  • Manually delete and reinstall the problematic mod/addon.
  • Clear the %temp%\CF folder.


If unresolved, please contact support and include your logs.


Missing required disk permissions for installation

  • Ensure antivirus isn’t blocking CurseForge or Minecraft files.
  • Run CurseForge as administrator.
  • Try repairing the folder permissions:

  • Make sure that your Windows user has full control over the modding folder. For example:


  • On macOS, enable access for the app to the Documents folder:

     

Oops, that was not supposed to happen!

Follow the general troubleshooting instructions outlined Here.


Something went wrong, please try again

Please contact support and include your logs.


Sorry, we can’t load this project. Missing dependency: []

This is often due to a missing file or dependency. Please contact support and include your logs.


This game is already being tracked by the CurseForge App

You can see the existing game instance/installation when opening the game's settings. For example:



This is an invalid directory or unsupported game

Make sure you have selected the folder that contains the game's .exe (Windows) or .app (MacOS) file.

For example, in World of Warcraft, select the _retail_ folder.

Minecraft Errors

An access violation occurred when attempting to install Minecraft launcher

  • Make sure your system user has full control over the modding folder. Try using a different drive if needed.



  • Try to install the modding folder in a different location, like C:\[folder]\ (Windows) or /Users/Shared/[folder]/


An invalid folder path was chosen

Refer to the installation path guidelines. Avoid selecting Desktop, OneDrive, root folders, or paths with special characters.


An unexpected error occurred while trying to install Minecraft

Please contact support and include your logs.


A required dependency could not be installed. Aborting installation.

This happens when a required mod has been deleted or is unavailable. Contact the mod author or support.


CMD configuration may be causing issues

Follow the instructions to reset or repair CMD-related configurations.


The decryption operation failed, see inner exception

Temporarily disable your antivirus or programs like Intel Killer that may interfere with connections.


Failed to create Minecraft directories

Make sure your user has all permissions enabled for the system's user folder (e.g., C:\Users\[your user]).



If the issue continues try changing the modding folder location to C:\[folder]\ or /Users/Shared/[folder]



Failed to download the Minecraft launcher due to a network error

Check your network connection.

This may also be a server issue- check CurseForge X/Twitter & CurseForge Discord for updates or contact support for assistance.


Failed to find Minecraft process 

Try repairing the installation or use a different modloader (Forge/Fabric). If issues persist, please contact support and include your logs.

 

Failed to install Minecraft launcher

Please contact support and include your logs.


Failed to launch modpack. An unexpected error occurred

Please contact support and include your logs.
 

Failed to set installation path

Avoid invalid directories, such as:

  • Desktop (including a folder within the desktop) or OneDrive
  • Vanilla Minecraft folder (C:\Users\[user]\AppData\Roaming\.minecraft\) 
  • Paths with non-English character /special characters 
  • Root directories (C:\, D:\, etc.) as in - the first or top-most directory in the hierarchy 
  • Drives with low storage
  • Folders without permission


Failed to unzip Minecraft launcher

This requires deeper investigation. Please contact support and include your logs.


Forge Modloader installation failed

Refer to Issues Related to the Forge Modloader for help.


Invalid file

Only modpacks exported using the CurseForge format can be imported. For more information, please visit this article: Sharing Modpacks/Custom Profiles


Java Runtime Environment is missing or out of date

Modloader installation failed

Use the "Repair installation" option:



If the issue continues, verify your network connection.


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

Please contact support and include your logs and the full error message.


Profile name should not include special characters

Avoid using special characters like *, [, / in profile names.


Unsupported mod loader

Use a compatible modloader version or type for the selected Minecraft version.


You need at least 10GB to install new modpacks

Ensure your system drive (typically C:) and modding drive both have enough space, as installation requires temporary storage in %temp%.

World of Warcraft Errors

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

Choose a different name for the sync group. You already have one with the same name.

Other Game Errors

SMAPI is required to play Stardew Valley with mods

SMAPI is the mod loader for Stardew Valley. It’s compatible with GOG and Steam versions. 

If you’ve tried the suggested solutions and are still encountering problems, please contact support and include your logs.