The basic process: read, extract, and place files in the right folder
Kerbal Space Program mods are folders or files you read and move into your game's GameData directory. The process is straightforward: find a mod you want, read it, extract the compressed file if needed, then drag the mod folder into GameData. The game reads everything in that folder when it starts, so mods load automatically without any launcher or extra step.
Most mods come as .zip files. You extract these using your computer's built-in tools — right-click and choose "Extract All" on Windows, or double-click on Mac. After extraction, you'll see a folder with the mod's name. That folder goes into GameData, which lives inside your main KSP installation directory.
The hardest part is usually finding GameData in the first place. On Windows, it's typically at C:\Program Files\Steam\steamapps\common\Kerbal Space Program\GameData (if you installed through Steam). On Mac, it's in Applications > Kerbal Space Program > GameData. If you installed KSP elsewhere, navigate to your installation folder and look for the GameData subfolder.
Key Takeaways
- Mods go into the GameData folder inside your KSP installation directory, and the game loads them automatically when you start.
- Most mods read as .zip files that you extract using your computer's built-in tools before moving the folder to GameData.
- CKAN is a mod manager that handles downloading, extracting, and organizing mods for you, and it prevents conflicts between incompatible mods.
- Some mods depend on other mods to work, so read the mod's description on SpaceDock or CurseForge to see what it needs before installing.
- Backup your GameData folder before installing many mods at once, so you can restore it if the game won't start.
Where to find mods: SpaceDock and CurseForge
SpaceDock is the main repository for KSP mods. Nearly every popular mod is there, with descriptions, read links, and version history. When you visit a mod page, scroll down to find the read button — it usually says "read" with a version number next to it. Read the description first to see what the mod does and what other mods it needs.
CurseForge also hosts KSP mods and works the same way. Both sites let you filter by version of KSP, which matters because a mod built for KSP 1.12 might not work in KSP 1.11. Check which version of KSP you have before downloading — you can see it in the main menu of the game.
Avoid downloading mods from random websites or forums. SpaceDock and CurseForge are where mod creators officially post their work, and both sites scan for malware. If a mod isn't on either site, it's likely abandoned or not trustworthy.
Using CKAN to manage mods automatically
CKAN (Comprehensive Kerbal Archive Network) is a mod manager that downloads, extracts, and installs mods into GameData for you. Instead of manually handling .zip files, you open CKAN, search for a mod, click "Install", and it handles the rest. CKAN also prevents you from installing mods that conflict with each other or require a different version of KSP.
To set up CKAN, read it from ckan.net, extract the folder, and run KSPCkan.exe (Windows) or the equivalent on Mac. The first time you run it, CKAN asks you to point it to your KSP installation folder. After that, you can search for mods by name, read their descriptions, and install them with one click.
CKAN shows you dependency chains — if a mod needs another mod to work, CKAN will install both. It also warns you if installing a mod will break something else. For someone installing many mods, CKAN saves hours of manual work and troubleshooting.
Understanding mod dependencies and version compatibility
Some mods depend on other mods to function. For example, many visual enhancement mods need Module Manager, a utility that lets mods modify each other's settings. If you install a mod that needs Module Manager and you don't have it, the mod won't work or the game might crash on startup.
Every mod page on SpaceDock or CurseForge lists its dependencies under a section called "Requirements" or "Dependencies". Read this before downloading. If a mod needs Module Manager, Kopernicus, or another utility, read and install those first, then install the mod that needs them.
Version compatibility matters too. A mod built for KSP 1.12 usually works in KSP 1.12.1 or 1.12.2, but might not work in KSP 1.11. The mod page shows which versions it supports. If you're unsure whether your version of KSP is compatible, check the game's main menu — the version number appears in the lower left corner.
Troubleshooting when mods don't load or the game won't start
If you install mods and the game won't start, the most common cause is a mod that doesn't match your KSP version or a missing dependency. Start by removing the last mod you installed — move its folder out of GameData, try starting the game, and see if it loads. If it does, that mod was the problem. If it doesn't, remove the next-most-recent mod and try again.
If the game loads but a mod isn't working, check the game's log file. On Windows, it's at KSP_Data\output_log.txt inside your KSP folder. On Mac, it's in ~/Library/Logs/Unity/Player.log. Open this file in a text editor and search for the mod's name or the word "error". The log usually tells you what went wrong — a missing dependency, a version mismatch, or a conflict with another mod.
Before installing many mods at once, back up your GameData folder by copying it to a safe location. If something breaks, you can restore the backup instead of troubleshooting each mod individually. To restore, delete the broken GameData folder and copy your backup back into place.
How to uninstall or disable mods
To remove a mod completely, find its folder in GameData and delete it. The game will no longer load it when you start. If you're not sure which folder belongs to which mod, check the mod's page on SpaceDock — it usually shows the folder name.
If you want to keep a mod but temporarily disable it, rename its folder by adding ".disabled" to the end — for example, change "ScienceAlert" to "ScienceAlert.disabled". The game ignores folders with ".disabled" in the name. Rename it back to enable the mod again.
If you used CKAN to install mods, you can uninstall them through CKAN instead. Open CKAN, find the mod in your installed list, and click "Remove". CKAN will delete it from GameData and remove any dependencies that nothing else needs.
Common mods to start with
Module Manager is a utility that many other mods depend on. Install it first if you plan to add multiple mods. Kerbal Engineer Redux adds real-time information about your rocket's performance and fuel. MechJeb automates some piloting tasks and provides detailed telemetry. Distant Object Enhancement makes distant planets and moons visible in the sky.
Start with one or two mods you're genuinely interested in, make sure they work, then add more. Installing too many at once makes it hard to figure out which one breaks the game if something goes wrong. Most players find that five to ten mods is a comfortable number that adds features without overwhelming the base game.
Frequently Asked Questions
Do I need to restart the game after installing a mod?
Yes. The game reads GameData when it starts, so you must close and reopen KSP after adding or removing a mod. If you install a mod while the game is running, it won't load until you restart.
Can mods break my save file?
Mods don't usually damage save files, but removing a mod that was part of a save can cause problems. If you had a mod installed when you created a save, keep that mod installed when you play that save. If you remove it, the game might crash or behave strangely.
What if a mod I want isn't available for my version of KSP?
Check the mod's page on SpaceDock to see if an older version supports your KSP version. Some mods have multiple versions listed. If none match, the mod may be abandoned. You can either update KSP if the mod is important to you, or find a similar mod that does support your version.
Is it safe to install mods from SpaceDock and CurseForge?
Yes. Both sites scan uploads for malware and host mods from known creators. Mods are just code and files, not executable programs, so they can't install anything on your computer without your permission. The main risk is a mod conflicting with another mod or your KSP version, not security.
How do I update a mod to a newer version?
Delete the old mod folder from GameData, read the new version, extract it, and move the new folder into GameData. If you used CKAN, it handles updates automatically — open CKAN, find the mod, and click "Upgrade".