Troubleshooting

If you're encountering problems using mods, this page might have the solution.

TIP: Use your browser's Find feature (usually Ctrl+F) to search this page for error messages you've encountered.

Problems and Error Messages

Each entry in this section has a list of clickable links to directions on trying that fix approach.

I installed mods, but they don't seem to be doing anything

• Read the Mod's Documentation to find out how to access its features.

• Did you accidentally launch in "No Mods" mode?

• Check the tags on the mod.io page - is the mod not updated for this game version yet?

• Check your log files for error messages - sometimes mods can error in ways that don't get caught by Mod Reporter

• Ask for Help on the Discord

• Reporting Bugs

Can't join my friend's multiplayer game

See below.

Game version mismatch when playing multiplayer

• Read the general multiplayer notes

• Ensure that all players have exactly the same mods installed

• If you're using mod.io interation, did it automatically update a mod on you? This means your installed mod version doesn't match the host's. One of you needs to update. Consider switching to manual mod installation to avoid the possibility of unexpected updates.

• Ask for Help on the Discord

Help, my game is crashing

The most common cause of this is installing broken or outdated mods.

• Check your log files for error messages

• If you are playing from the Xbox Game Pass version, some mods can crash, even if they work on a normal PC install. Best solution if you want to play with these mods is to get the game on Steam.

• Uninstalling Mods - remove mods until the problem stops to track down what mod was causing the problem.

• Ask for Help on the Discord

• Once you find out what mod in specific is the cause - Reporting Bugs

"Mods" menu on the title screen does not load (Failed to Fetch)

• Launch the game in "No Mods" mode then unsubscribe from mods - remove mods until the problem stops to track down what mod was causing the problem.

• Ask for Help on the Discord

Failed to create mod on mod.io: Api failed to complete the request

• Try uploading the mod manually.

Command give does not exist!

You did not properly install the chat commands mod, or something is preventing it from loading.

• Are you sure you've subscribed to Chat Commands and not just CoreLib.Commands?

• Manually subscribe to all of a mod's dependencies

• Try uninstalling the mod then installing it (and its dependencies) via another method.

• Ask for Help on the Discord

Quantum Processor Error: Command <something> could not be found.

• Run chat commands in the game's chat window, not the debug Quantum Console. If you still want to use the quantum console, prefix your commands with the word chat so they are executed as chat commands.

---

Fix Approaches

This section contains troubleshooting approaches for the above problems to link to.

Install the Mod Reporter mod to check for loading errors

The Mod Reporter mod provides a GUI on the main menu to view the current state of your installed mods and see any issues easily.

0ModReporter for Core Keeper - mod.iomod.io

Check your log files for error messages

Take a look at your game log files to see if any mods are reporting errors.

Read the Mod's Documentation

Check for directions on how to use the mod, known issues, etc. on the mod's page on mod.io.

Manually subscribe to all of a mod's dependencies

The game's mod.io integration often fails to download mod dependencies. Visit the mod's page on the mod.io website to see what they are and manually subscribe to each of them.

Ask for Help on the Discord

Join the Core Keeper discord and ask for help in the #modding-help channel. Make sure to:

• Include your log files! It will be the first thing people ask for if you don't provide it.

• Mention what mods you are using.

• Say what you expected to happen, and what actually happened. Screenshots help too.

• Say if you're playing in singleplayer, multiplayer, or a dedicated server, and if you're the host or the client.

Remember to communicate what you fixes have already tried. People are a lot more willing to help if you make it clear you've already put in some effort!