Common Crashes - EverestAPI/Resources GitHub Wiki

What should I do when Celeste crashes?

DON'T PANIC

Your first questions should be "Is my Everest version up to date?" and "Are my mods up to date?", as sometimes neglecting updates will cause compatibility issues to arise. If updating both Everest and your mods does not fix the issue (or they're already up to date), continue onwards.


Read the first line of the error (after the timestamp). It should contain the following:

System.{ERRORNAME}Exception: {Description of the error}:

As a user, first read through the following list of common errors for something matching or similar to the {ERRORNAME} or description of the error displayed in the log, and follow the instructions provided.
If the particular error is not in the list, no fix is provided, or the fix does not work, then proceed to the instructions below to report the issue.



System.OutOfMemoryException

You've got too many mods (including maps) installed, and your poor PC can't handle them all at once. Try blacklisting or uninstalling some of them.

  • To disable a mod while Celeste is running, open the Mod Options menu from the main menu and select the option to Enable or Disable Mods.
  • If you are unable to start Celeste, you can still do so through Olympus in the "Manage Installed Mods" menu.
  • If you don't want to/can't use Olympus, go to the Mods folder next to Celeste.exe, and add the name of the zip/folder in the blacklist.txt file. For example, if you want Everest to skip over CrystalValley.zip and Dadbod.zip, just put those in blacklist.txt:
CrystalValley.zip
Dadbod.zip
  • To uninstall a mod, just go to the Mods folder next to Celeste.exe, and delete the mod's zip/folder. This also can be achieved through Olympus.

Tip

The mod you are trying to blacklist may already be in blacklist.txt with a # before it. Simply removing the # will cause the mod to be blacklisted.

If you are out of luck or don't have much RAM, you can make Everest only load textures when they are required. Please note this can cause issues. For that, open Saves/modsettings-Everest.celeste in a text editor (f.e. Notepad) and change LazyLoading_Yes_I_Know_This_Can_Cause_Bugs from false to true.

System.NullReferenceException

This error means that something wasn't initialised properly, and has a variety of causes.

When alt-tabbing to/from Celeste

It seems that Celeste sometimes crashes when its resolution changes while fullscreen, which happens when switching focus. You can try switching to the FNA version 🔗 of the game, which fixes this due to different fullscreen behaviour.

Mentioning at Celeste.Parallax..ctor

This is because a styleground texture is missing; make sure all required mods are installed, and if it's your map that the styleground is attached to, that it points to a valid png image file.

When leaving a room that has a Theo Crystal in it

There is a vanilla crash when leaving a Theo room in directions other than rightwards; using an Extended Variants crystal instead avoids the crash.

Mentioning at Microsoft.Xna.Framework.Graphics.SpriteBatch.Draw

This is a known race condition when debug mode is enabled, you might be able to open Everest normally if you just try again, afterwards be sure to disable Debug Mode to prevent this, alternatively if its crashing consistently: go to your Saves folder, open settings.celeste, scroll down until the LaunchInDebugMode tag and set that to false, then open modsettings-Everest.celeste in that same folder, and set DebugModeInEverest: false as well.

Mentioning at Monocle.BitTag.op_Implicit(BitTag tag)

This is not the main crash, this is a common "side-error" from an actual critical error, please seek in your log the actual first critical error in it.

System.IO.IOException: The process cannot access the file '$any file$' because it is being used by another process.

Something is using a file that Everest wants to remove/modify, this can usually be fixed by restarting your computer or looking and terminating whatever process may have that file open.

System.IO.IOException: Too Many Open Files

Celeste has too many files open.
When installing mods, it is not necessary to extract them, as Everest will read the .zip files automatically. This is actually preferable, because it means that your operating system will only see each mod as one file, rather than potentially hundreds.
Make sure downloaded mods are in .zip files, especially as some systems/browsers will automatically try to unzip them.

Ionic.Zip.BadCrcException or System.IO.InvalidDataException: End of Central Directory record could not be found.

Something went wrong while downloading a mod.
Somehow one of your mod zips got corrupted, and will need to be reinstalled.
If you have an idea of which one it may be (if you downloaded one recently, or if you can check your log.txt for the last loaded mod), then delete it from your Mods folder and re-download it.

System.Exception: FMOD Failed: ERR_NOTREADY (Operation could not be performed because specified sound/DSP connection is not ready.)

This is usually caused after an Everest update with FMODLiveUpdate enabled, be sure to disable it if you don't use it actively. This can be disabled manually by editing the same files as in here but editing the parameters that mention FMODLiveUpdate instead (should be right next to those).

System.Exception: FMOD Failed: ERR_EVENT_ALREADY_LOADED

Two FMOD banks define the same event.
If you aren't actively using FMOD, this error is usually caused by having more than one copy of the same mod (and therefore the same audio bank) loaded at the same time.
Check your Mods folder carefully for duplicate mods and remove them.

System.Exception: FMOD Failed: ERR_OUTPUT_INIT

Something went wrong with the sound engine used by Celeste.
Possible fixes are:

  • Unplug/replug your speakers/headphones
  • Try a different set of speakers/headphones
  • Restart your audio drivers/your PC
  • Update your audio drivers

Steam not found!

Ensure that Steam is running, restart it if necessary.

AggregateException: One or more errors occurred

Can be caused by an outdated Everest version.
Update Everest to the latest version through Olympus.

System.ComponentModel.Win32Exception: SELinux execheap probe failed! Please ensure Everest has this permission, then try again

This occurs due to a permission error on Linux systems running SELinux 🔗, such as Fedora. To resolve this, use the following steps to allow Celeste to have the permissions it needs:

  1. Open a terminal window on the computer the crash happened on and run sudo cat /var/log/audit/audit.log | grep -a execheap | grep -a Celeste
    • This searches the SELinux logs for entries showing that it denied Celeste execheap, which is a permission that .NET needs to function properly.
  2. If you see an output like type=AVC msg=audit(1702580366.688:3126): avc: denied { execheap } for pid=353681 comm="Celeste" ..., then continue with these steps. If you get an error or no output, follow the instructions below to report the issue.
    • This output indicates that such entries exist in the logs, indicating that Celeste was indeed denied this permission.
  3. Run sudo cat /var/log/audit/audit.log | grep -a execheap | grep -a Celeste | sudo audit2allow -M everest_core_fix
    • This finds the same entries as before in the SELinux logs, and then creates a rule that tells SELinux to allow Celeste to have this permission.
  4. Run sudo semodule -i everest_core_fix.pp
    • This enables the rule that was created in the previous step, allowing Celeste to have the execheap permission. After following these steps, try launching Celeste again. If the issue is not resolved, please report this on Discord.

System.DllNotFoundException: Unable to load DLL 'CSteamworks': The specified module could not be found. (Exception from HRESULT: 0x8007007E)

Not necessarily CSteamworks but if you encounter this its generally recommended to verify game files (Steam 🔗 / Epic Games 🔗 or reinstall the game manually if that's not an option. Finally install Everest again if you desire. Note: this is not a guaranteed fix, but it has been useful for many users.

System.InvalidOperationException

Something entered an invalid state. This can have different causes:

Mentioning 0x887A0006, 0x887A0007, or 0x887A0020

This is mostly caused by a lack of system resources or a graphics driver issue. Make sure you have enough RAM and VRAM available for the game - try disabling mods you don't use, or closing programs you don't need. Otherwise, if you think this is your graphics drivers' fault, be sure to update those to the latest version.

System.ArgumentNullException: Value cannot be null. (Parameter 'method')

This is caused by an old version of Strawberry Jam 🔗 combined with a newer version of Factory Helper 🔗, just update Strawberry Jam 🔗 to fix this. You can update mods through Olympus in the "Manage Installed Mods" menu in the "Update All" green button.

System.TypeLoadException: Derived method 'OnSquish' in type 'Celeste.Mod.MaxHelpingHand.Entities.RespawningBounceJellyfish'...

This is caused by an old version of Maddie's Helping Hand 🔗 combined with a newer version of Bounce Helper 🔗, just update Maddie's Helping Hand 🔗 to fix this. You can update mods through Olympus in the "Manage Installed Mods" menu in the "Update All" green button.

System.ArgumentException: Source method is generic, generic hooks are not supported

An old version of Isa's Grab Bag 🔗 is the only mod known to cause this when combined with a newer Everest version, just update Isa's Grab Bag 🔗 to fix this. You can update mods through Olympus in the "Manage Installed Mods" menu in the "Update All" green button.

System.Net.Sockets.SocketException: *any message* or System.Net.Http.HttpRequestException: *any message*

This is mostly due to issues in your network connection, make sure it is stable enough and that you can reach most web pages. Also make sure that there aren't firewalls that may be blocking certain sites that the game accesses (such as GameBanana).

System.UnauthorizedAccessException: *anything*

There was some permission issue in your game files and the process cannot continue:

  • If you encounter this while installing Everest, verify game files and reinstall Everest. It may also be useful to completely wipe the game from your disk (be sure to back up your Saves though!) to reset all files to their default permissions.

System.DllNotFoundException: Unable to load shared library '...' or one of its dependencies

A library required Everest or some mod could not be loaded. The exact solution depends on the library mentioned in between the single quotes. Look through the options below and see which one matches your case.

Mentioning /tmp/mm-exhelper.so.xxxxxx

Update Everest to the latest version of your desired branch. Alternatively, enable the executable stack in the Celeste binary. You can do this by installing the execstack AUR package on Arch based distributions, or prelink package on Debian based distributions, and running execstack -s /path/to/the/game/directory/Celeste. (the file called Celeste, not the folder)

This is caused by glibc 2.41, where the stack is no longer executable if a shared library requires it.

Mentioning fmodstudio

Verify game files (Steam 🔗 / Epic Games 🔗) or reinstall the game manually if that's not an option.
Then, make sure that the orig folder is deleted, backing up your save files if necessary. Reinstall Everest afterwards.

This is caused by glibc 2.41, where the stack is no longer executable if a shared library requires it.

System.DllNotFoundException: libfmodstudio.so.10

This crash happens in vanilla only. It is fixed by a Celeste update (which was pushed on February 7th, 2025).
Update Celeste. Alternatively, verify game files (Steam 🔗 / Epic Games 🔗) or reinstall the game manually if that's not an option.

This is caused by glibc 2.41, where the stack is no longer executable if a shared library requires it.

System.ArgumentException: Destination is too short. (Parameter 'destination')

Update Everest to the latest version of your desired branch, this is a bug in an old MonoMod version.

Yo, I heard you like Everest so I put Everest in your Everest so you can Ever Rest while you Ever Rest.

This message is only present on really old versions of Everest, please update it, then come back here if the issue persists.

System.TypeInitializationException: The type initializer for 'System.Net.ServicePointManager' threw an exception...

This is not actually a Celeste crash but rather an Olympus issue, update it since this error only exists on old versions of it.

System.InvalidOperationException: An unexpected error has occurred. with at Microsoft.Xna.Framework.Graphics.GraphicsDevice.DrawUserPrimitives

This should only occur in vanilla versions of the game that are running with XNA, FNA is known to be more stable nowadays so switch to the "opengl" branch if on steam or use the "opengl" build if on itch.

System.InvalidOperationException: PE image does not have metadata.

Your vanilla Celeste install in orig/Celeste.exe got corrupted. Verify game files (Steam 🔗 / Epic Games 🔗) or reinstall the game manually if that's not an option. Reinstall Everest afterwards.


Reporting Issues

There are two ways of reporting issues:

Discord (preferred)

  • Join the Mt Celeste Climbers Association Discord:
    Discord Invite 🔗
  • Report your issue in the #modding_help channel, following the checklist.
  • Wait patiently for someone to help you.

GitHub (only for issues with Everest itself, not with mods)



Reporting Checklist

  • Describe what you were doing before you encountered the error.
  • If it was working previously, list any changes you made to your game since then.
  • Include what you have done already to try to fix it.
  • Attach the error_log.txt and log.txt (both located in your Celeste folder).
    If you got the Catastrophic Error warning, then only the log.txt is needed.
  • If this is an error you believe to be specific to a mod, notify the mod author if possible.

Important

If you have restarted your game since the crash, your log.txt will have been reset.
Everest will automatically store past logs in the LogHistory folder, which is also in your Celeste folder.

⚠️ **GitHub.com Fallback** ⚠️