Before you start

Uninstall any other FTL mods before proceeding!

NOTE This guide assumes the GoG installed version and that it’s installed to ~/GOG Games/FTL Advanced Edition (the GOG Games folder in your user’s home directory) If you are using the Humble Bundle version or have installed the GOG version somewhere else the instructions are exactly the same but obviously the game’s location may differ.

NOTE This guide assumes your system is using KDE Plasma as the desktop environment (Same as the Steam Deck & Kubuntu) and shows shortcuts and navigation in the filebrowser & apps common to KDE, if you’re using a different desktop environment things might be slightly different but it should be close enough to send you down the right path. One noteable thing Konsole is KDE’s form of the terminal/command line/xterm/gterm/whatever your system calls it.

1. Launch FTL to make sure you’re running the correct version
2. Ensure the version says 1.6.12 in the lower right.
3. Download Hyperspace FTL-Hyperspace.x.x.x.zip from here to your Downloads folder Do not extract this ZIP yet
4. Download Vhati’s Slipstream 1.9.1 for Linux to your Downloads folder Do not extract this tar.gz yet
5. Open your file browser and navigate to the FTL install folder and into the game & data folders
6. It should look like this, for an unmodified vanilla install
7. Open the Downloads folder in a new window where we previously downloaded Hyperspace & Slipstream to
8. Right click the Hyperspace zip file and Open with Ark as we need to extract just a few files from it and not everything
9. Expand the Linux folder in Ark by clicking on the little arrow to the left of it.
10. Select only Hyperspace.1.6.12.amd64.so and liblua5.3.so.0 and drag them over to the data folder to extract them there
11. Your data folder should now look like this
12. Right click the FTL file and Open with KWrite or whatever text editor you want
13. Modify the last few lines of the file to look EXACTLY like this You must add these two lines before the exec line but after the other export lines

    export LD_LIBRARY_PATH="$here":${LD_LIBRARY_PATH}
    export LD_PRELOAD=Hyperspace.1.6.12.amd64.so
    

    For reference, BEFORE it will look like this:

    export LANG="${LC_ALL:-$LANG}"
    export LC_ALL=
    export LC_NUMERIC=C
    exec "$here/$command.$arch" "$@"
    

    AFTER it must look exactly like this at the end of the file:

    export LANG="${LC_ALL:-$LANG}"
    export LC_ALL=
    export LC_NUMERIC=C
    export LD_LIBRARY_PATH="$here":${LD_LIBRARY_PATH}
    export LD_PRELOAD=Hyperspace.1.6.12.amd64.so
    exec "$here/$command.$arch" "$@"
    

    So to be clear you are just adding the two lines but it’s very important you add them before that last line of the file that has exec

14. Save the file & close KWrite

    Slipstream

15. Go back to the downloads folder
16. Right click SlipstreamModManager_1.9.1-Unix.tar.gz and go down to Extract and select Extract archive here
17. Navigate into the SlipstreamModManager_1.9.1-Unix folder NOTE At this point we’re done with the Ark window for Slipstream (but not the other Ark window that has Hyperspace.zip open) we’re also done with any use of SlipstreamModManager_1.9.1-Unix.tar.gz so you can delete it now if you want to free up space.
18. Navigate into the mods folder It should look like this without any mods added
19. Go back over to the Ark window that has the hyperspace zip file open & select Hyperspace.ftl
20. Drag Hyperspace.ftl over into the mods folder of Slipstream NOTE You can now close the hyperspace Ark window and delete Hyperspace.x.x.x.zip from your downloads if you want we’re done with it for good
21. Navigate back up to the slipstream folder (you can click SlipstreamModManager in the title bar like I show here
22. Launch Slipstream by right clicking modman.command and selecting Run In Konsole
23. Slipstream will likely not auto-detect a GoG or Humble install, you’ll have to tell it where the FTL.dat file is
24. Select that it was not installed via Steam
25. Your choice, yes/no if you want it to check for updates
26. Slipstream running, check the box next to Hyperspace and hit Patch
27. Say NO to running the game right now, we need to stop here and go disable steam cloud saves & delete the save files to ensure a successful start.

    Removing old saves that will probably freeze the game

28. Go back to your file browser (Dolphin) select Home on the left hand side
29. Select the hamburger menu in the top right and check Show Hidden Files
30. Navigate into the .local folder
31. And then the share folder
32. Find the FasterThanLight folder, you can back it up somewhere at this point if you want to save your vanilla save
33. Right click FasterThanLight and select Move to Trash
34. Launch FTL
35. You should see a language selector if you deleted all the saves correctly.
36. You should notice it says HS-x.x.x x64 in the upper right corner, this indicates the Hyperspace.so file is running The 1.6.12 (Hyperspace x.x.x) in the lower right indicates a successful patching of Hyperspace.ftl with slipstream. You should see BOTH indicators showing hyperspace is running correctly.

Multiverse Install

1. Download the “RAW Files” for Multiverse and not the installer
2. Open your downloads folder
3. Open slipstream’s folder in a new window
4. Open slipstream’s mods folder
5. Move over the two multiverse mod zips
6. Navigate back up to Slipstream’s folder and right click modman.command and Run in Konsole to start Slipstream again
7. You should see something like this, with the Multiverse files missing, don’t panic we need to tell slipstream to see zip files as mods
8. Go to slipstream’s preferences
9. Check allow_zip
10. Apply
11. Now we need to tell slipstream to Re-Scan mods/ under the file menu
12. Multiverse now shows up in the mods list
13. Check both multiverse files but do not select Hyperspace exactly as shown here
14. Hit Patch
15. If patching completed without error, you can launch the game here or from Steam (if you got an error in patching, download the zip files again you might have a corrupted download)
16. First the game loading should show up like this
17. After a short amount of time you should see HS-x.x.x x64 in the upper right indicating the version of hyperspace that is loaded correctly
18. Enjoy the game