Uninstall any other FTL mods before proceeding!

Downgrading & Installing Hyperspace Library

This downgrader will ONLY work for Steam’s 1.6.14 version of FTL, if you have any other FTL install not from steam you need to look at the other install instructions for your source.

1. Start FTL, at the main menu in the lower right it MUST say Steam Version: 1.6.14, if it says 1.6.9 you have already downgraded. If it says anything else you might have some mods still installed!
2. Download FTL-Hyperspace.x.x.x.zip from here
   • (where x.x.x is the version of Hyperspace)
   • Don’t download the source code zip or tar.gz, only the FTL-Hyperspace zip
3. Navigate in Steam to FTL and browse local files.
4. Your local files should look like so: (please note there are some language differences in Windows here)
   • You should see the same file sizes and files present
   • 
5. Open FTL-Hyperspace.x.x.x.zip that you downloaded

6. Open the Windows - Extract these files into where FTLGame.exe is folder in the zip

7. Extract all the files & folders in the Windows folder to the same location where FTLGame.exe is on your computer
   • do not extract the entire zip to the folder, you only need the contents of the Windows folder for this step
   • NOTE: Hyperspace 1.2.0 and above will also have a lua.dll that must also be extracted but is not shown in these screenshots.
   • 
8. At this point your game folder should look exactly like this:
   • You might have a crashlogs folder or a settings file or a couple extra log files but there shouldn’t be any other files in here, no .ftl files no zip files.
   • NOTE: Hyperspace 1.2.0 and above will also have a lua.dll that is not shown in these screenshots.
   • Your ftl.dat should be very close or exactly the same size or else you might still have mods installed
   • 
9. Double click and run downgrade.bat
10. After downgrading your game folder should look exactly the same as here
    • Please note the size of FTLGame.exe and FTLGame_orig.exe if, FTLGame.exe is not 122MB then the downgrade was not successful
    • 
11. Hyperspace is now Halfway-installed you still need to patch a FTL Mod which uses hyperspace.

Patching in hyperspace-based mods with Slipstream

Installing Slipstream

1. Make certain you have a vanilla FTL install before doing a new install of slipstream or upgrading slipstream
   • If you check the size of ftl.dat in your FTL install folder it should be around 270MB (or 212MB for GoG) or so, if it’s significantly larger you still have mods installed and you need to revert to vanilla first!
   • Slipstream 1.9.1 is not smart about checking if the file is vanilla, it will use whatever ftl.dat exists when you first open it (so if you have mods installed & you run a new slipstream install it will consider that one “vanilla” even if it’s not!)
   • Save yourself many heacahes & problems by making sure you have a clean vanilla ftl.dat first
2. Download slipstream 1.9.1
3. Extract it to a folder where you’ll keep it around, do not run it from inside the zip
4. You must have Java installed on your machine (probably fine for most people)

Patching with Slipstream

1. Download the hyperspace-based mods you are interested in
2. Launch slipstream
3. Click Open mods/
   • 
4. Move the mods .ftl or .zip files from wherever you downloaded them into this mods folder
5. Rescan mods
   • Go to file Re-Scan mods/
   • 

Most Hyperspace Mods

1. Move Hyperspace to the top of the list in slipstream
2. Patch Hyperspace and any other hyperspace mods after it you want
   • 
   • DO NOT Patch Multiverse See Below for Multiverse instructions.
3. Click Patch
4. Launch FTL
5. See: Checking if Hyperspace is installed correctly

Multiverse Only

1. Enable Slipstream’s ability to recognize ZIP files as mods
   • Go to slipstream’s preferences
   • 
   • Check allow_zip
   • 
2. Rescan mods
   • Go to file Re-Scan mods/
   • 
3. Patch multiverse
   • Patch FTL-Multiverse as the first in the list
   • Do not select Hyperspace
   • Patch any FTL Multiverse compatible mods after multiverse
   • Do not patch mods that are not designed for FTL Multiverse or they may conflict (even small UI mods can sometime conflict, seek help on the MV Discord if you have questions about a specific favorite mod of yours compatibility)
   • Example:
   • Click Patch
4. See: Checking if Hyperspace is installed correctly

Installed Correctly

• If hyperspace’s DLL is installed correctly, you’ll see a little message in the top right of FTL about half-way through the loading screen and on into the menu screen that looks similar to this (it’ll look a little different for each version):
  • 

• After that if you get a version AND you patched with Slipstream correctly

• You should get to your mods main menu with no errors or warnings, Multiverse 5.2.3 installed correctly looks like this:
  • 
• FTL Strawberry Edition looks like this:
  • 
• FTL Hyperspace with no other mods looks like this:
  • 

Installed Incorrectly

• If you see your mod’s main menu but there is no version information in the upper right, Hyperspace’s DLL might not of been installed correctly.

• If you get an error message about AcheivementTracker you did not downgrade FTL to 1.6.9 successfully.

• If you see an error message about hyperspace.xml not found you may have failed to patch Hyperspace.ftl or Multiverse with slipstream

• If you see an error message about patching both multiverse & hyperspace you either patched both in Slipstream and need to correct this, or you didn’t have a clean FTL.dat before installing slipstream and slipstream thought that your FTL.dat was vanilla and you need to clear slipstream’s cache & revert to a vanilla FTL.dat.

Special Thanks

Special thanks to Cedric for providing many of the install images from Windows above