Skip to content
FTL: Hyperspace

Install FTL: Hyperspace on Windows with ftlman

ftlman is the mod manager built for Hyperspace. It downloads whichever Hyperspace release you pick, applies it to your copy of FTL, and keeps your mods in one list you can reorder and re-apply whenever you like. FTL itself has to be on 1.6.9, so the rollback comes first.

  1. Steam settings

    Section titled “Steam settings”

    Skip this if you did not buy FTL on Steam.

    Right-click FTL: Faster Than Light in your library and open Properties.

    Show me how to open PropertiesRight-clicking FTL in the Steam library and choosing Properties

    Under General, untick Keep game saves in the Steam Cloud. Turn off Steam Cloud first. It restores outdated saves with broken state, which can keep Hyperspace from launching and will undo any save fix you try later.

    Show me the checkboxThe General tab of FTL's Steam properties with the Steam Cloud checkbox unticked

    Then under Updates, set automatic updates to Only update this game when I launch it.

    Your saves live in Documents\My Games\FasterThanLight. To get there, open File Explorer and paste %USERPROFILE%\Documents\My Games into the address bar.

    Rename FasterThanLight to FasterThanLight-backup, then launch FTL. The game makes a fresh folder, and your original saves stay in the backup if you ever want them back.

    Do this once, right after turning Steam Cloud off. Cloud sync leaves behind a save that Hyperspace cannot read, which freezes the game at the end of the loading bar.

  2. Roll FTL back to 1.6.9

    Section titled “Roll FTL back to 1.6.9”

    The Windows build of Hyperspace only runs on FTL 1.6.9. If Steam, GOG or Epic gave you anything newer (and they will have), roll it back first.

    1. Open FTL-Version-Rollback and choose Code → Download ZIP, then extract it.
    2. Copy the extracted contents into your FTL folder, next to FTLGame.exe. That is usually C:\Program Files (x86)\Steam\steamapps\common\FTL Faster Than Light.
    3. Run rollback.bat.

    Your original executable is kept as FTLGame_orig.exe, so this is reversible.

  3. Set up ftlman

    Section titled “Set up ftlman”

    Ftlman is the recomended mod manager for FTL: Hyperspace modding. Actively maintained and supports Hyperspace updates

    1. Download the build for your machine from the ftlman releases page.
    2. Extract the ftlman folder anywhere you like. It does not have to live in your FTL directory.
    3. If FTL is currently modded, revert it to vanilla first.
    4. Run ftlman. A Steam install is detected automatically. If yours sits somewhere non-standard, or you have more than one copy and want a specific one, open Settings and set FTL data directory yourself.

  4. Install Hyperspace

    Section titled “Install Hyperspace”
    1. At the top left of the ftlman window is a Hyperspace dropdown listing every release. Pick one. Take the newest unless a mod you want specifically asks for an older one, and note that Multiverse always wants the newest.
    2. Press Apply. ftlman downloads it and installs it for you, so there is nothing to copy into your FTL folder by hand.

  5. Add your mods

    Section titled “Add your mods”
    1. Put your mods in the mods folder inside your ftlman folder. The download already contains one.
    2. Press Scan in the top right so ftlman picks up what you just added.
    3. Tick the mods you want. Order matters here: drag them into place, because some mods have to sit above others. The mod’s own page will say when it does.
    4. Press Apply.

  6. Check it worked

    Section titled “Check it worked”

    Launch FTL. About halfway through the loading screen, and again on the menu, a small version string appears in the top right. That is Hyperspace reporting itself, and it means the binary is loaded.

    If your mod’s main menu comes up with no errors, you are done.

Hyperspace is now installed and ready to play. Everything below is optional.

Adding Multiverse

Section titled “Adding Multiverse”

Multiverse is the largest mod built on Hyperspace, and it installs differently from everything else.

  1. Open the Multiverse release thread and scroll to DOWNLOAD RAW FILES (OTHER PLATFORMS, UPDATES, MANUAL INSTALL). Ignore the installer above it, that one is Windows-only and does its own thing.
  2. Download both files listed there, the Assets File and the Data File.
  3. Put both .zip files in your mod manager’s mods folder.
  4. Patch them in this order, and nothing else:
  • Press Scan in the top right so the new files show up
  • Drag Multiverse Assets above Multiverse Data
  • Tick both
  • Leave Hyperspace unticked
  • Press Apply
Show me what it should look likeftlman with Multiverse Assets ticked directly above Multiverse Data, and Hyperspace.ftl left unticked

Updating

Section titled “Updating”

Open ftlman, pick the newer release from the Hyperspace dropdown and press Apply. Your saves are not affected.

Uninstalling

Section titled “Uninstalling”
  1. Clear the Hyperspace dropdown.
  2. Untick every mod.
  3. Press Apply.

That puts ftl.dat and your FTL folder back to vanilla in one go.

To go back to FTL 1.6.14 as well, delete FTLGame.exe and rename FTLGame_orig.exe back to FTLGame.exe.