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 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.
  • 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. 

On Windows, refer to Microsoft’s article on resetting the Hosts file.


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 permissions 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)

Try restarting the app or repairing folder permissions. Ensure the game is not running, and use a tool like LockHunter to unlock any stuck files.

 

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.


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, confirm access 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

The game is already detected. You cannot add it again.


This is an invalid directory or unsupported game

Ensure you’ve selected the correct folder. 


For example on World of Warcraft:

  • Select _retail_ for Retail
  • Select _classic_ or _classic_era_ for other versions

Minecraft Errors

An access violation occurred when attempting to install Minecraft launcher

Make sure your system user has full permissions to the modding folder. Try using a different drive if needed.


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 antivirus or programs like Intel Killer that may interfere with connections.


Failed to create Minecraft directories

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


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


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 / Failed to install Minecraft launcher

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

 

Failed to launch modpack. An unexpected error occurred

If using “Skip launcher with CurseForge,” try logging out and back into your Minecraft account. Otherwise, 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


We recommend using C:\CurseForge\ or similar paths.


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. Please follow the steps to export your modpack.


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 + 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.