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.
Each entry in this section has a list of clickable links to directions on trying that fix approach.
#read-the-mods-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
See below.
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.
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
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
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.
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.
This section contains troubleshooting approaches for the above problems to link to.
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.
Take a look at your game log files to see if any mods are reporting errors.
Check for directions on how to use the mod, known issues, etc. on the mod's page on mod.io.
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.
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!