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.
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
Can't join my friend's multiplayer game
See below.
Game version mismatch when playing multiplayer
Game version mismatch when playing multiplayerRead 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.
Help, my game is crashing
The most common cause of this is installing broken or outdated mods.
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.
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)
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.
Failed to create mod on mod.io: Api failed to complete the request
Failed to create mod on mod.io: Api failed to complete the requestCommand give does not exist!
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?
Quantum Processor Error: Command <something> could not be found.
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
chatso 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.
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!
Last updated
