Clean and reinstall process

Jonny Spruce edited this page Apr 4, 2018 · 2 revisions

If you have installed all your mods through CKAN, it is a quick and painless process to completely re-create your modded KSP installation. This will clean up most CKAN errors you may be experiencing.

Phase 1 - Save your installed mods as a "favourites" list.

  1. Open the CKAN GUI client
  2. Click on the File menu, then select Export installed mods...
  3. Browse to a location in the Export Mod List dialog box
  4. Type a filename for your mod list
  5. In the Save as type: drop down, select "CKAN favourites list (*.ckan)
  6. Click the Save button
  7. Close the CKAN client

Phase 2 - Clear out your KSP installation

  1. Open your operating system's file manager/explorer program
  2. Go to your KSP game folder (directory)
  3. Copy the "CKAN" folder to "CKAN-backup"
  4. Open the "CKAN" folder
  5. Select all files other than the "downloads" folder
  6. Delete the selected files
  7. Return to KSP game folder
  8. Copy your "GameData" folder to "GameData-backup"
  9. Open your GameData folder
  10. Select all contents, then find the "Squad" and "SquadExpansion" (if present) folders/directories and un-select them
  11. Delete the selected files & folders

At the end of this process you should have a "CKAN" folder containing a "downloads" folder which contains all your cached downloads, and a "GameData" folder containing just the original "Squad" folder with all its contents as installed with the game.

Phase 3 - Reinstall your mods

  1. Open the CKAN client
  2. Click on "Refresh" to get an up to date list of mod releases
  3. Click on the File menu, then select Install from .ckan...
  4. Find and select the file you created in Phase 1
  5. Click on Open
  6. Click on Continue

If any of your mods were old versions, they will be downloaded and the new versions will be installed, while all other mods should be installed from cache.

Phase 4 - Tidy up

If all your mods are installed successfully and you are no longer experiencing errors, perform the following steps:

  1. Return to your operating system's file manager/explorer program
  2. Delete the "CKAN-backup" and "GameData-backup" folders

If instead, things are now worse than they were before, perform the following steps before continuing your troubleshooting:

  1. Return to your operating system's file manager/explorer program
  2. Delete the "CKAN" and "GameData" Folders
  3. Rename the "CKAN-backup" folder to "CKAN"
  4. Rename the "GameData-backup" folder to "GameData"
Clone this wiki locally
You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.